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The purpose of this document is to define and discuss the Haster 
Control Program II CHCPJ for the 91000 machines- The concept and 
design of the HCP wiM be discussed and the functional 
specifications of the HCP*s operations will be cstaloguad. 

The sort, data eommuni cati on * and data management systems will 
not be discussed in any depth in this document. Detailed 

descriptions of these features appear in other Burroughs 
publications CSee Related Document at i on below). 
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Name 



Number 



31000 HCP Utilities 

81000 Network Definition Language 

B1000 Data Hanagement Systems II 

81300/81700 Sort 

81000 Software Operations! Guide 



P.S. 
P.S. 

P.S. 



2212 

2212 

2212 

P.S 



55/9 

5223 
5470 
2201 



1058751 



6752 



These 



programming 



specifications are written for those people with 

and a knowledge of basic software 



exper i ence 



design wilt 



concepts. Those unfamiliar with operating system 
gain insight into the Burroughs philosophy of system management. 
Those individuals familiar with operating systems of other 
manufacturers or of other Burroughs machines will gain an 
understanding of the Master Control Program implsmentei 
specifically for the Burroughs 81000. 



Also included in this specification are drief descriptions ot 
various functions performed by the micro-coded 1/0 driver 
routines* These same routines are often referred to as "GISH0" 
and -I/O interpreter". The discussions are neces sa ry for 
completeness and for a thorough understanding of the dlOOO 
operating system of which the 1/0 driver is an integral part. 



HCP II is a modular* supervisory program that assuies ""°"r 
logically complex functions to simplify and expedite the tasks ot 
programming and system operation. Its most important duties 
include such functions as: 
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* Scheduling* initiation* cunning* and termination of jobs 

* Providing a symbolic weans of communicating with the system 
while shielding the user from the detail of the hardware 

* Providing a family of com son facilities such as management 
of input/output operations and file maintenance 

* Managing the system's resources for optimum utilization in a 
mul ti -pro gram mi ng environment 



The B1000 is a small-to-medium scale* general purpose computer 
system. Its distinguishing feature is its flexibility* made 

possible through interpretive processing. In any computer system 
a representation of any process has two components: CI) a family 
of structures representing the state of that process* and (2) a 
series of operators able to manipulate those structures. Until 
the advent of fourth generation computers* both components were 
represented in the machine hardware itself. A compiler or 

language translator transformed the source code (e.g.* C08QL* 
FORTRAN) into a "machine language** Cobject code) which was 
defined in terms of the hardware architecture. 

For the set of processes able to be generated by any particular 
programming language* there exists a machine architecture which 
best represents those processes. For instance* COBOL is a 

character-oriented language and performs decimal arithmetic 
exclusively. Because of its data manipulation features* it might 
best utilize a machine architecture with multi-address operators? 
capable of performing efficient "moves*" "compares*" and simple 
expression evaluation. On the other hand* FORTRAN was designed 
to compute complex mathematical functions. It favors a stack 
structure for parameter passing and couple x expression 
evaluation. It performs binary arithmetic and would prefer 30- 
to 50-bit word sizes. 

The difficulty of designing a hardware structure capable of 
handling two such divergent languages in the most efficient 
manner becomes apparent. It would be possible* in principle at 
least* to design the hardware in such a way as to adecuately 
represent both sets of structures. However* this would prove to 
be prohibitively expensive. The typical approach* therefore* has 
been to either design tha hardware to favor one language at the 
expense of others or to design a compromise structure capable of 
handling several languages* but none in the most efficient 
manner* The wide variety of programming languages in current use 
has placed a great strain on the capacity of the hardware to 
efficiently execute code compiled from very different langiages. 
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It is to this probie® that designers of fourth generation 
software* and the B1000 in particular* have addressed the*selves. 
Rather than build a particular structure into the hardware* the 
concept of the "soft machine" has been developed whereby the 
ideat environment of structures and operators is progr asi at icall y 
si mutated. 

The B1Q0O hardware was designed with as little explicit structure 
as possible. Because memory may be addressed to the bit* no one 
structure is inherently favored over any ether. The only 

required structure is that which will allow the simulation of any 
"soft machine". Thus the range of structures able to be 

represented on the 81000 is unlimited. 

As stated previously* for every compiler language there exists a 
machine architecture within which the algorithms generated by 
that compiler will best run. On the 81000 this hypothetical 
environment is called the "S-machine"* An S-machine has been 
defined for each language such that any process may b« 
represented in its most efficient or most natural form* 
unrestrained by any arbitrary hardware configuration. 

Compilers on the 31000 generate code files which contain (1) the 
information necessary to initialize the appropriate S~machine at 
run time* and €2) the *5~code* to be executed om this S-machine. 
S-code is written in S-language* the machine language for an 
S-machine. Execution is achieved by the 5-code bein^ 

interpreted* an S-operator at a time* by a micro-program called 
an interpreter. 



SflEIiiAfiE 



The term "software"* as used in this document* refers to aii 
programming supplied by the Santa Barbara Plant. When the tern? 
is used* it most likely is referring to programs that are written 
in a higher-level language. This may not always be the case* but 
typically* the term will refer to the compilers and utility 
programs created by the Programming Activity. 
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The firmware consists of a set of interpreters* those portions of 
the MCP which are micro-coded and reside in an entity frnown as 
the MICRQ/MCP* and a program called "GIS&G*. For each S-language 
a micro-coded program called an interpreter acts upon the 
hardware and executes the co ftp a ted 5-code as defined by the 
5-machine. The 81000 software has been implemented in such a way 
that any number of interpretive structures say be active in the 
system at any given tine* This is achieved by dynamically 

estabt i shing* upon deitand* the S-machine structure for any 
pr ocess* 

For instance* the NCP* which is itself a program* is written in a 
high-level language* SOL* that is designed specifically for 
writing software. It has its own optimum environment (the SOL 
S-machine) consisting of the structures and operators required 
for software applications- It has its own 5-ianguage and its own 
interpreter (the SDL interpreter)* Running simultaneously in the 
sy stew may be another pro-grass written in i different language 
(e.g.* COBOL). This program also has its own structure (the 

COBOL S-mactiine)* 5-language* and interpreter. The syste** when 
executing the MCP f s supervisory functions* assumes the 
architecture of the SOL 5-machine and* when executing the C03CL 
instructions* takes on the C080L 5-machine structure. This 
switching of interpreters and process environments is managed 
completely by the software and is invisible to the user of the 
machine* 



The 81000 MCP has actually evolved to its present state. 
Originally* all functions of the HCP were coded in SDL. 
Beginning with the 4.0 release of the software* the rcost comionly 
used routines of the MCP were written in micro-code and placed in 
GISHO. This resulted in substantial performance improvement s. 
Beginning with the 5.1 release of the software* these cononly 
used routines were removed from GISHO and placed in the entity 
mentioned previously* the HICRG/HCP. 



These specifications have also evolved along with the #CP. Hany 
of the functions described herein are now performed by tha 
HICRQ-HCP* though the furction itself remains exactly the saae as 
it was when it was performed by SOL code. Since this document is 
intended to be a functional specification of the 81000 operating 
system* all HCP functions are described herein. Whether the 

function is performed by SOL code or by micro code should be 
completely transparent to the user. Actually* the functional 
result is the same for both* but the time and resource 
requirements are not identical. The difference is therefore not 
always transparent. 
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Throughout this document* the acronym "HCP" may be referring to 
the MICRO/HCP or to the SOL HCP. In cases where the distinction 
is important* *MCP* will not be used but the two terms asertioned 
above will be. This document* then* will, actually be a 

functional specification of the operating systea* as it was 
originally intended to be* though it will actually be describing 
two separate and distinct programs. Since GI5M0 is also a 

critical part of the operating system* the document lay also 
touch upon portions of 61SH0. 

Gl SHO is a aicro~coded family of critical routines connon to alt 
processes. GISNO may also be referred to in this document as 
«CSH_ W » an acronym for Central Service Module * It is a central 
nodule of service routines used by all programs in the systen and 
performs three basic functions* 

1. Switching of control between all contending processes in the 
system* 

2. Recognition and queueing of interrupts received frosi the I/O 
controls or froni other processes in the system* 

3. Initiation and management of the I/O controls connected to 
the machines* usually at the request of another process. 

Processor allocation* the switching of control between two or 
wore processes* is handled by the "Hicro Scheduler- aiodute in 
GI5NG. This module maybe thought of as an "Outer Loop". It has 
absolute control over the process which wilt be performed next on 
the system. 

Interrupt resolution consists of routines which perform certain 
functions depending on the type of interrupt and certain other 
critical conditions. The interpreter in control senses tha 
interrupt and calls upon GISMQ to take the required action. 

GISMO*s service request module (soft I/O) performs the function 
of a hardware device capable of performing a memory access at the 
request of an I/O control. An I/O control on the 8100Q is a 
hardware device which acts as an interface between soft I/O and a 
peripheral device. It requests access to memory on behalf of the 
device and aanages the device itself. The collection of I/O 

controls is called the I/O sub-system. 



Typical data transfer operations involve frequent but brief calls 
upon soft I/O by the I/O sub-system. The firmware was designed 
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two S- operators* 



in such a way that between the execution of any 

the interpreter in control wi4l check a flag in the processor 

(called the Se rvice Request 8it) to see if the I/O sub-_5jrsteff. is 



control to 



de^a ndlna__ a t tent ion * If it is# the interpreter passes 

GISHO which performs the necessary memory access and returns 

control to the interpreter* 
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Before proceeding with a detailed description of what the KCP 
does and how it goes about if it will be necessary to define a 
number of terras and data structures whose naraes are used 
familiarly throughout the document. The c eader s *°«" J' " '*!! 
meanings of the terms, but a thorough understanding of the many 
diverse programming structures presented herein is rot required. 
The structures are presented only in the interests or 
completeness, and as a possible aid in understanding the 
narrative descriptions of the MCP's functions, presented in the 
later sections of the specification. 
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The MCP organizes and allocates space 
of fields known as memory links. Each 
the block of memory it describes and 
as: The size of that block of memory? 
to which it is put; and pointers to 
and succeeding links. If the block of 
available (i.e., not currently in 
additional set of descriptors point to 



in memory through the us 3 
link immediately precedes 
includes such information 
the type of use Cif any) 
the immediately preceding 
memory is classified as 
use by any process), an 
the links of the prior 



available and next available blocks of memory. Thus it n 
possible to search all links or only those links describing 
available memory. A programmatic description is given below. 



QSK.ADR, 



DEFINE MEMORY .LINK. SIZE AS #l8f#? ..,„,.*. 

DECLARE MEMORY .LINK TEMPLATE 8IKHEH0R Y.LINK . SI ZE) f 
DEFINE MEMORY. LINK. DECLARATION AS t 
DECLARE 01 DUMMY REMAPS MEMORY.LXNK, 
2 ML. DISK 
2 ML. GROUP, 
3 ML. POINTER 
3 ML. JO 8. NUMBER 
3 ML. TYPE 
3 ML.5A¥E 
2 ML. SIZE 
2 ML. PRIORITY. FIELD 



3 ML. DK. INTERVAL 

3 ML. CURRENT. OK. INT 

3 ML. INCOMING. PRIORITY 

3 ML. RESIDENCE. PRIORITY 



4 ML.RP 
4 ML.RP 
ML. FRONT 

ML. BACK 

ML. USAGE. BUS 



WHOLE 

FRACTION 



ADDRESS, 

8IT116), 

BITC6), 

8ITC1), 

BITC24), 

BITC30), 

8ITC10), 

8ITC10), 

BITC5), 

8ITC5), 

8ITC4), 

8ITCI), 

8ITC24), 

eiTC24), 

8ITC2), 
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3 ML-PREVI0U5.SCAN.TQUCH SITC1)# 

3 -HL.CURRENT.SCAN. TOUCH BIT(1>;#? 

USEt ML. DISK 

*ML. POINTER 
»ML. JQB.NUHBER 
,ML. TYPE 

*HL.SAVE 

*NL.SIZE 
*ML. FRONT 
*HL.8ACK 
) OF MEMORY.LINK. DECLARATION? 

OEFINE Q.HL. DECLARATION ASJOECLARE 
01 Q.HEMQRY.LINK TEMPLATE 

02 FILLER 8ITCHEM0RY. LINK. SIZE) 

, 02 G*ML.F»AVL ADDRESS 

f 02 Q.ML.B.AtfL ADDRESS 



DEFINE 




TAKE.LO AS#0# 


# 


TAKE. RIGHTMOST AS#1# 


DEFINE % TYPES FOR "ML. TYPE" 




CODE AS #0#% 


p 


AVAILABLE AS #2#% 


p 


RN.5 AS tltt 


p 


MCP.TEMP AS #4#% 


9 


USER. FILE AS #5 #2 


9 


SES.QICTV AS #6#% 


P 


NICRGCOOE *?*% 


9 


OICT. MASTER AS #8# 


P 


QUEUE. DIRECTORY. TYPE 




AS #9# 


P 


M5G. 8UFFERV 




AS #10# 


P 


MESSAGE. LIST-TYPE 




AS #111 


P 


TO. BE. FORGOTTEN AS #12# 


P 


OATA.SEG AS #13# 


P 


D8H. BUFFER AS #IA# 




TERMINATING LINK AS #15#% 


P 


MCP.PERH AS #16#2 


P 


PSR.MEM AS #17#2 


» 


MCP.IGAT AS #18#2 


P 


DISK. HEADER AS #19#% 


9 


PACK. HEM AS #20#* 


P 


SD.CNTNR AS #21#% 


* 


SCHEO.HEH AS #22#% 


P 


SORT. HEN AS #23#% 


P 


OCH.NEH AS tZktt 



MICROCODE. N9N.0V£RLAYA3L£ AS #25#X 
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QUEUE. AVL.8UF.V AS #26# 

* 0M5.0I5K.HDR AS#27#X 

p QMS. STRUCTURE AS#2d#% 

* CMS. TEMP AS #29#X 

* OMS. GLOBAL S AS #39#% 

p DHS. TEMP. LOCK. QE5CR AS #3i# 

* XM. MEMORY AS #32# 

* PERM.SPQ.8UFF AS tilt 
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"TEMPLATE** in the above description is defined as "REMAPS BASE*. 
This is not important to an understanding of memory link 
operation. •ADDRESS" is defined in the MCP symbolic as 

•8ITC24)*. The word "ADDRESS" here is used as a denotation of 
memory address. Hence* "ML. SACK* in the description above is j 
pointer to the previous memory link and "ML. FRONT" is a pointer 
to the succeeding 4 in*. ML. SIZE will contain the size of the 
area* in bits* and ML. GROUP is valid only if the area is in use. 
ML. POINTER will contain the memory address of the segment 
dictionary entry associated with this memory area. Segment 

dictionaries are described in the next section. ML. JOB. NUMBER 
will contain the job number of the program using the ar^a. 
ML. SAVE* the description of which is defined as "BOOLEAN*" is set 
on i f the nenory area must ba saved on disk before it is 
overlaid. 



As can be determinad toy adding the siies of the various 
components* a nenory link requires 187 bits of storage space. 
Since memory is allocated dynamically* it is often difficult to 
predict with any degree of accuracy exactly how isuch memory will 
be required by any task. The sizes of all memory links irvolvel 
must be included in the calculations* This is discussed further 
in a later paragraph* 
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Vi dua I me mo r_y_ i s supported by allowing process segmentation. 8y 
segmenting code* data* and interpreters and dynamically moving a 
segment into or out of memory as required* the system is able to 
function as if it had "virtually infinite" memory capacity. Ths 
MCP manages this facility through three structures: C ode Segment 
n^ct jonar* es» Data Segment Dictionaries* and 1 n t e r p r ajjer. -SjBLag e n t 
Pi c tJonari_ es* Each dictionary consists of a string of system 

descriptors each of which describes one segment including its 
length* location and status* As a segment is moved 
memory its dictionary entry is updated accordingly. 



in or ott of 



At run time the 
dictionaries from 



MCP creates the 
information in the 



code and 

pr o gr a m * s 



data segment 
code file. The 
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interpreter segment dictionary Is created from the interpreter 
code file in the same manner and is referenced by an entry in the 
interpreter dictionary* a structure fixed in memory at 
Clear/Start time. The run structure of the program contains 

pointers to the code and data segment dictionaries and an index 
into the interpreter dictionary. A programmatic description is 
given be low 2 



SISIffl fl£5£5i£IflfiS 



DECLARE 

01 SYSTEM 



DESCRIPTOR TEMPLATE 81 TC SY.SIZE 3 5 



% 
DEFINE 
DEFINE 
01 



SY. DECLARATION AS #5Y .0ECL( SYSTEM. DESCRIPTOR* #? % 
SY.OECL(X) AS #9ECi.AR£X 
DUMMY REMAPS X»X 

6XT(1)» X TO HELP 

BIT(l)* % = I 5K* 

8ITCi)# % 

3ITU)» X 



02 

02 
02 
02 



02 
02 
02 



SY.IN.USE 

SY. MEDIA 

SY.LOCK 

SY. IN. PROCESS 



02 SY. INITIAL 



02 SY.FILE 



02 



02 



SY.OK.FACTOR 

SY.SEG.PG 

SY.TYPE 



SY. ADDRESS 
03 FILLER 

03 SY.CORE 
SY. LENGTH 



MEMORY MAhAGEMENT 
1=S-MEMGRY 



ITC1), 



BITU), 



BITC3) 

9IT(D# 

8IT{4>* 



8IT(36># 
9ITC12)# 
BITC24)» 
8ITC24); 



% 
X 
X 
% 

% 

% 
X 

% 
% 

X 

X 

% 
% 

% 
% 
% 
% 

X 
X 

X 

% 

X 



X 

X 

% 

X 

% 

X 

% 



TRUE IF THERE IS AN I/C IN 
PROCESS FOR THE INFORMATION 
REPRESENTED BY THIS DESCRIPTOR* 
IF TRUE* "5Y.CORE* CONTAINS A 
POINTER TO THE I/O DESCRIPTOR. 
"ADDRESS" IS READ-ONLY MOTHER 
COPY* HENCE IF "WRITE" THEN GET 
HEU DISK AND REPLACE ADDRESS. 
THE OBJECT OF THIS DESCRIPTOR 
IS A FILE WHOSE USERCQUNT MUSI 
BE DECREMENTED WHEN THIS 
DESCRIPTOR IS RETIRED. 
MEMORY DECAY FACTOR 
MEMORY. ACTIVITY AUDITING 
UNITS FOR SY. LENGTH. 



BITS 
DIGITS 



€4 BIT) 



= CHARACTERS C8 BIT) 
= NORMAL DESCRIPTORS 
= DISS SEGMENTS 
= SYSTEM DESCRIPTORS 
= SYSTEM IMTRINSIC 
= INCIRECT REFERENCE 

ADDRESS GIVES RELATIVE 

DISPLACEMENT IN 3ITS 

(SIGNED NUMBER). 

MICROS 



8 = 



PORT, CHANNEL AND 
CORE* OR ADDRESS 
NUH8ER OF UNITS* 
BY SY.TYPE. 



UNIT. 

WITHIN UNIT. 

AS DETERMINED- 



?»' 
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% 
% 

DEFINE NO. DECLARATION ASK 
DECLARE 

01 0UMHY REMAPS NORMAL .0E5CRIP TOR SIR NO .SHE ) * 
02 NO. DK. FACTOR BITO>* 

02 FILLER 8ITCS3* 

02 HO. CORE 8XT{2U* 

02 NO. TYPE 9IU3)* 

02 ND.LEMGTH BITC24}*#* 

SY.SIZE is defined in the HCP code as eighty. Hence eighty bits 
are required to contain one segment dictionary entry* or system 
descriptor. The use of the term -DESCRIPTOR" in 81000 

documentation is often misleading and ambiguous. There are many 
different types of descriptors* all of which have different 
memory requirements and formats. Consequently* systes 

descriptors will always be referred to as such or as segment 
dictionary entries* 

The comments on the various fields comprising the system 
descriptor are largely self-explanatory. Perhaps sosa 

explanation of selected fields would be beneficial* however. 
SY.LOCK is set true if the system descriptor describes a data 
field and if the interpreter is currently accessing the field. 
This is to avoid the situation which arises in a simple 
replacement statement where the sending and receiving field are 
both in overlayable segments. In order to do the r epiacement * 
both data segments must be in memory simultaneously. 

SY, INITIAL is true for initialized data only. The most common 
case of this occurs when executing a COBOL program and the 
programmer has used the value clause to initial i2e data fields 
and the data field itself is in an overlayable segment. 
5Y.A00RESS may be either a disk or a memory address* depending on 
the setting of 5Y.ME0IA* If it is a memory address* the most 
significant twelve bits are ignored* If it is a disk address* 
the most significant twelve bits contain the port* channel and 
unit associated with the disk address. 

iai£B£BEIJEfl MMSOOI' £h&MLim %LSQ£$ hUU DISIIfliMfilES 

The 81000 MCP maintains a list or directory of all files or disk. 
file stored on disk has * unique name* which may consist of Lp to 
three fields* each of which may consist of up to ten characters. 
A s.s oc_jjitad _w*th each file on di sk is an item called a "D is k F i I e 
H£]ai§rJ% The disk file header serves essentially to describe the 
file. A€t of this is described in detail in later sections. 
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This brief discussion is being included at this point to 
facilitate the following discussions on interpreters. 

Included in the disk file header is a field which denotes the 
type of file. There are separate type numbers for data files* 
code files* interpreters* and so forth* Ctut e files (progr ams) 
and __ i n t er pr e t er s j^e_AuJi±hsiL^d33J:jLl be d by .the f i r s t d is fc„. semper t" 

contained in the file. Thj s _ segment is ca lled the _* Pro gr.a» 

plSfaffleleZrlZZSEox"**^ or""'" the ~~" "Inter prefer " Tsraraeter eiocfc w * 
respectively. A detailed description of the program psrafnter 
blocfc is presented in a later section. A pr ogr amtat ie 

description of the interpreter parameter block is presented 
below. 



DEFINE IPB. DECLARATION AS# 

DECLARE 01 OUHMY REMAPS IPS BIU1440}* 

02 FILLER SITMI92)* 

02 IPS. HARDWARE CHAR*!)* 

02 IPB.ARCHITECTURE.NAME CHAR(IG)* 

02 IP8. COMPILER. LEVEL 8ITC8)* 

02 IPB. MCP. LEVEL 8ITC83* 

02 IP8.GI5MQ. LEVEL 811(83* 

02 IPB. ARCHITECTURE. ATTRIBUTES BITC30)* 

02 FILLER 8ITC56); 



#? 



IPS. HARDWARE will contain either an "S" or an "ft"* depending upon 
whether the interpreter was generated for an 5-aiemory or an 
M- memory processor. All BlBQd's are considered to be H-menvry 

processors. IPS. ARCHITECTURE-NAME will contain the generic name 
of the compiler* such as COBOL or FORTRAN. IP8. COMPILER. LEVEL 
will be a number which will correspond to the release level of 
the software* as described below. IPB. MCP. LEVEL* IPB. GISMO. LEVEL 
and IPB. ARCHITECTURE. ATTRIBUTES are parts of the interpreter 
verification feature of the HCP. 



The 81000 HCP includes facilities to recognize the hardware 
configuation it is executing upon and select the corresponding 
interpreter from the disk directory. Alt programs which are 
compiled for execution on a B1000 will have an interpreter w TfPE rt 
requested the program parameter block of the code file (described 
in a later section)* or the specific name of the interpreter to 
be used. As explained in a later section* the program parameter 
block contains space for three names to be associated with an 
interpreter* For discussion purposes here* the three nawes will 
be referred to as the "PACK* 1 name* the * t FANIL¥ n name ard the 
-OFFSPRING" name. 
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The 31000 compilers generate the last two names of the 
interpreter only. The family name generated always ^responds 
to the language the program is written in* such as cchul or 
"FORTRAN". The offspring name is always one of the reserves 
words "INTERP*** -DEBUG - or "TRACE*. At 80J* the HCP modifies the 
offspring name by concatenating one numeric character den «ting 
the compiler level and either the character -M- or -S- depending 
upon whether the machine is equipped with an S-memory or an 
M-memory processor. 

The level number concatenated is contained in the program 
parameter block as -PROS. COMPILER-LEVEL". Every time the 

compilers are changed in such a manner that the interpreter must 
also be changed, the level number generated by the compiler is 
incremented. The interpreters are then modified accordingly and 
released to the field under a new name. The new name will be the 
same as the old one* except for the level number contained in the 
name. For a COBOL program which is being «™;Ut«d on a 
Blr-20-series machine and had been compiled by the 4.1 COBOL 
compiler* the HCP will generate -C0B0L-/-INTERP1M- as tha 
interpreter name to be used for the execution. It should be 
noted that this feature was first included in the 4.1 """a™ 
release. Level numbers were not included in the program 

parameter block prior to the 4.1 release. 

Once the interpreter name is generated* the di sfc directory is 

searched for the interpreter. Upon finding the interpreter* the 

HCP will bring it into S-memory* if it is not already there* arid 

construct an entry in the -INTERPRETER. DICTIONARY *. Al 

interpreters are re-entrant on the BiOOO. All of this i, 
described in greater detail in the paragraph which follow. tacn 
entry in the interpreter dictionary has the following format. 

OEFINF 10. DECLARATION ASIDECLARE 

01 DUKMY REHAP5 INTERPRETER .DICTIONARY* 

02 I0.SEG.0IC SY.Q5CR* 

02 ID. ENTRY. IN. USE BOOLEAN* 

02 I9.RSONT.USERC0UNT 8IT<7>* 

02 IQ-TQTAL.USERCGUNT BITC7>* 

02 IO.MIN.H.SIZE BITC43* 

02 10. WAX. N. SIZE 8ITC4}* 

02 10. PARTIAL. BIT BOOLEAN* 

02 ID. BLOCK. COUNT 8ITC4)* 

2 f I LL £R 8ITC19)* 

02 10. N. PRESENCE. BIT BOOLEAN* 

02 I0.M.A0QR 8ITC12)* 

02 I0.T0PN 8ITC4)* 

02 10. 'MEDIA BITC2)* 

02 10. LOCK - BOOLEAN* 

02 FILLER 8IT <* 3 *' 

02 10. TYPE 3ITC4)* 



2-i 
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IQ. ADDRESS 
03 FILLER 
03 ID. CORE 
02 ID.LENGTK 



GMPANl CONFIDENTIAL 

31000 MCP II 
P.S. 2212 5462 C£) 



8ITC36)* 
8ITC12)* 
BITCZ4)* 
8ITC24);#; 



There is one entry in the interpreter dictionary for each 
interpreter presently in use. The I/O driver is always the first 
interpreter entered in the dictionary* the Micro HCP is thi 
second entry and SOL is always the third entry in the dictiorary. 
On the B10GO* it is possible to segaent interpreters. 
Consequently* a code segment dictionary is constructed for each 
interpreter as it is brought into memory* The system descriptor* 
the first item in the interpreter dictionary* is a pointer to the 
interpreter* s code segment dictionary- Interpreters may be 

segmented* exactly as programs are- The same routines in the HCP 
are used for handling program segments and interpreter segments* 

A certain amount of information about each program currently 
Peing executed is maintained in memory by the HCP* The field in 
which this information is maintained is known as the Run 
Structure Nucleus of the program. It is abbreviated as 

RS. NUCLEUS. In the RS* NUCLEUS* there is an index into the 
interpreter dictionary. All programs being executed at any given 
time which are using the same interpreter will have the safe 
index in the field in their respective nucleus. In this manner* 
interpreter re-entrancy is acconpi i shed. 



interpreter dictionary entry will not 
at this point* For a more detailed 
management* the reader is referred to 
document which deals with H-memory 
sufficient at this point to say that 
all interpreter segments except the first are treated as ordinary 
code and are considered overlayable. The first segment of each 
interpreter is not treated as code and is not overlayable* 
however • 



The remaining field in the 
be described in detail 
description of interpreter 
the section of this 
management* It should be 



The 1/0 driver* which is considered 
exception to the above statements* 



an 



i nterpr eter * 



i s 



an 



£fi0£ £IL£i* PSQSaii ZMMZ1L& SLS£lSi AUJ2 EIL£ EAflitiflEa SLJ2S1SS 



The co dLSL_i i l e o f_ev erjL.cjrojgr aw. Mtt ..5t con tain two types of records 
HCP to manage the execution o f__Lfr a 1 program: the 

t he "Progra m Parameter JU oc If " 

plus 



to alUu&_JLhe 

w Fil.e. 
(PP8.). 
one entry 



Parameter" Block" 



Ihj&r_£__J_s one 
for 



anage 

<FP 3.)» and 

each fite declared 



FP8 for 



in a program 



a trace file 
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The first 2380 bits Itwo disk segments) of every code file is the 
"Program Parameter Slock* CPP8) whose format is rigidly defined 
by the HCP. Every compiler generates a PP8 of the same format. 
It provides* for the HCP* all the vital statistics of the program 
including: The program # s naie? the name of the i rt er pr eter to 
be used during execution? the relative addresses of the « P3 s* 
IP8* code segment dictionary and data segment dictionary* memory 
requirements for the program's execution* and tracing 

in format ion* 

At run time a working copy of the PP3 is written into a temporary 
or permanent log Cas dictated by the system options). The first 
two segments of this four segment entry are an exact copy of the 
PPB from the code file. Another segment is generated by the HCP 
and documents certain features of that particular execution. A 
final segment is reserved for an abnormal termination message. 

If the code file is an interpreter code file* it contains an 
additionai segment called the "Interpreter Parameter Block". It 
contains information concerning the software compatibility of the 
interpreter. A field in a program's PP8 specifies under which 

interpreter it will run. When the program is scheduled for 
execution* the IP8 of the interpreter named in the PPB is checked 
to insure that the interpreter is compatible with both the code 
file and the system software. The HCP informs the system 

operator via a SPfJ message if the interpreter cannot run. Refer 
to the appropriate HCP listing for a programmatic description. 

The " File Paraa r tr r fl inr V" rrPB-i j c * lA&O- hit r a cjuLd-cXLaaifl.d by 

.^ the compiler from the user's file attribute declarations. Its 

v/ / format is rigidly defined by the HCP* and it contains the vital 

'J statistics which allow the HCP to manage the file's usage. When 

a fob is scheduled for execution* a working copy of the ¥?% is 
{ ' written into a permanent or temporary log (depending on system 

options). In addition to recording the file's attributes* the 

X HCP documents the use of the file during that job's execution. 

It records such information as the number of times the file was 

opened and closed? the total amount of time the file was open; 

the number of records read* the number of I/O errors; and the 

file type. Refer to the appropriate HCP listing for a 

pr ogr am* at ic descr i p t i on • 






r 



EIL£ IHEiUSamflfl SU2£1S£;^^>'' 






As each file is opened by the user program* a structure kno*n as 

a hi* inflation Block tfIB) is cre ated in memory by the *C? . 

The FIB contains ail information necessary for the HCP to perform 
normal* requested* I/O operations on the file. Much of the 

information in the FIB is taken directly from the FP3. Other 



BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLAMT 



2-10 

COMPANY CONFIDENTIAL 

31000 HCP II 

P.S. 2212 5462 (E) 



information In the structure is inserted by the ¥CP* based upon 
the characteristics of the peripheral device assigned to the 
file. Device assignment is discussed in the section of this 
specification which describes the Open Comraunica te» 

FIB's vary in size* depending upon the type of device assigned to 
the file* Oue to the amount of information which «ust be 
maintained* a disk file FIB is much larger than that of a card 
punch file* for example. 

I/O descriptors and buffer memory areas are allocated and 
initialized by the HCP at the same tine* There will therefore be 
one memory link only* for each file that is active in a progra®. 
Suffer areas and descriptors are not normally shared between 
files* though the Oata Management subsystem* the Data 

Communications subsystem* the Relative file impl esent at ion and 
the Indexed file inp-1 erne rati on offer some exceptions tc this 
rule* 

A complete structural description of the FIB will rot be 
presented herein* due primarily to the length of the structure- 
Also* the FIB is of interest to the various portions of the 
Operating System only. The programmatic description of the 

structure is readily available in the MCP listing. Sizes of 
FI8*s for the different peripheral devices are presented in the 
following table. 



File Assigned to. 



Size in Sits 



Reader -S or ter 
Pr in ter 

Remote Device 

Tape 

Oi sk 

Queue 

All Other Devices 



742 
IZk 
557 
724 
976 
3B5 
612 



mu sifiiifiiusE 



The s t r uc tnc- a_ i n rceaory that represents the state of any proc.es. s 
i ^ the run struc ture. Each process has a unique run structure. 
When a Job is initialized before execution* the HCP creates ths 
run structure from an analysis of the program's code file* and 
adds certain information it will need for management of the 
execution. All run structures are linked together by priority. 



11 
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A run structure consists of a program's data or address spacer 
the M£PJ _* ■anagariat space called the run structure ru cl_eus£ and 
the flTe~lind data segment dictionaries. TTTe pro gram 31 s 



space* residing between its base and limit registers* 
area of memory that may be accessed and manipulated 
program itself. A program's base register is a memory 

that marks the tower bound of its addressable space, 
register specifies the upperbound. A program may not 

memory that is outside its own base to limit area* though thi s 
tenet is enforced by the interpreters and not the MCP. 



address 
is that 
by the 
address 
The limit 
access 



program's 



address space may contain ooth resident ani 
overlayable data. The resident data area contains those fields 
which will be present in memory throughout the duration of tha 
execution. The overlayable data space contains segmented data 
which may be brought into or out of memory as needed. 



B12H SIBil£IUfl£ M£UH£ 



The Run Structure Nucleus is an area structured and taintained by 
the HCP and contains the essential information about the program. 
It resides in memory directly above the program's limit register 
and is accessible by the MCP and the program's interpreter. 
contains such information ass 



It 



Pointers to 

BASE AND LIMIT 

SEGMENT DICTIONARIES ICOQE AND 9ATA> 

FILE DICTIONARY 

INTERPRETER DICTIONARY EMTRY 

NEXT RUN STRUCTURE <8Y PRIORITY) 

CGOE FILE ON DISK 

DISK LOCATION OF RUN STRUCTURE IF -ROLLED OUT" 

PROGRAM'S LOG ENTRY 

VICTUAL DATA SPACE ON OISK 

NEXT INSTRUCTION TO 8£ EXECUTED 

CMS POINTERS 

Structures necessary for communication between the program and 
the MCP 

Fields to reflect the state of the S-machine 
Fields for program switches 



A programmatic description may be obtained from the MCP listing. 
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The data segment dictionary resides at the end of the Run 
Structure Nucleus and is pointed to fay a field in the nucleus. 
If there is no segmented data and the user has not requested that 
his resident data area be initialized* then the pointer will be 
null* and there will be no dictionary. 



Each entry in the dictionary 
pointing to one data segment. 



is an 60-bit system descriptor 



The last aleaent of a run structure is the file dictionary. 
There is one 80-bit descriptor for each declared file plus one 
additional descriptor for a trace file tused for tracing). While 
a file is open* its dictionary entry points to the file's FI3 in 
meiRory. If a file has never been opened* its entry is null. If 
a file has been temporarily closed ti.e.* "CLOSE ROLLOUT")* it*? 
dictionary entry points to its FI8 which has been written to 
di s* .. After a permanent close* the file»s dictionary entry will 
again be null. 

fi£r£MfliJiI IMQUUM km £22£ 2£S&J!lI M£lIflMABI£5 



The eiOOO MCP allows re-entrant processing* the ability of two or 
store processes to use the same code segment dictionary and* 
thereby* the saine code. The code segaentls) and code segment 
dictionary reside outside a programs run structure* and a fieli 
in the run structure nucleus points to its code segment 
dictionary. A structure called the segment dictionary container 
contains the information necessary to govern the use of a 
particular code segment dictionary. When a job is being 

initiated for execution* the MCP determines whether or not tha 
code segment dictionary desired by the job is already in use. If 
it is* that dictionary will be used. The segment dictionary 

container reflects* among other things* the nuaber of processes 
using the dictionary it describes. If there is more than one 
user* the segment dictionary container will remain in memory 
until all users have completed execution. 
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This section of the specifications Is a description of: 



1/ 

GI 
1* 

2, 



5. 
4. 
5. 
6. 
Mo 
1. 
2. 
3. 
4. 
5* 
6. 
7. 
8. 
Fi 
1. 



fl Descriptors 
SHO Operation 

Channel Table 

GXSftQ/Hardware Interface 

1. CA/8C Cycles 

2. Processor I/O 

3. Service Re que 

4. Status Coynts 
5* Oat a Transfer 

I/O Chaining 
Disk I/O Chaining 



Instruct! on s 
st 



Disk I/G Overlapp 
Tape I/O Chaining 
nitoring of Periph 
I/O Assignment Ta 
Uni t Hneioni cs 
Test and Wait I/O 
STATUS Procedure 
Oisk Identificati 
Pack Information 
Tape Labelling* I 
Tape PE/WRZ Each a 
le Structures 
Conventional File 
I* File Attribut 
2. File Nailing C 
3- Logical Oisk 

4. Physical Disk 

i. Oisk So 
2, File 
3 » Oisk 
4» Oisk 

5. Hulti-Pacfc 

1* Base 

2. 

3- 

4. 



ed Seek 

eral Status 
Pie 

Operators 

on - Pack Labels 

Table 

ni ti al izat ion and Purging 

nges 



2. 



Ac 
Fi 

Fi 

Fi 
Pa 
Conti nu 
Multl-P 
Multi-P 
6. Printer Files 
1» Logical 
2* Logical 
/• Printer and P 
I* Backup 
2- Backup 
3. Backup 
Relative Files 
1* Direct Files 



s 

es 
on 
Fi 

F 
ac 
ce 
le 
ie 
le 
ck 
at 
ac 
ac 



vent ions 

ies 

il es 

e Allocation 

ss and Identification 

Identification 

Header 
s 

5 

ion Packs 

k File Information Table 

k File General Restrictions 



/Physical I/O Relationship 

Page Impiemen ta tion 
unch Backup Capabilities 
File Slocking Factors 
File Control Information 
File Record Format 
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Zm Data Structure 

5 » j sic Initialization 

4* File Parameter Slocks 

5. Disk Header 

5. File Information Slocks 

7m Communicate Operators 
3. Indexed Sequential Files 
I* Direct Files 

2. Index Files 

3. Cluster Files 

4. Oata File Structure 

5. Index File Structure 

6. Memory Structures 

1. FIB Dictionaries 

Zm User Specific Information CUSIJ 

3. File Global Information CGLCBALS) 

4. Structure Descriptor 

5. Disk File Header Extension 
7m Available Space Allocation 

8. Index File Table Splitting 

9. Current Record Pointer 

10. Current Maintenance 
11* Suffer Management 
12. Buffer Descriptor 

15. Concurrent Update Operations 
5. The I/O Error Procedures 

There is some overlap between the information contained in this 
section of the specification *nd that contained in the Oeiand 
Management section of the document* The Demand Management 
section was originally intended to cover the management of the 
>eripheral after it had been assigned to a user as a file? th~ 




specific question. 

I/Q CESfiBieiQaS 

Normal state programs request I/O functions in a symbolic fashion 
(e.g.* Write a Record)* The MCP must transform these expressions 
into explicit I/O operators called I/O descriptors* An 1/3 
descriptor allows the MCP to communicate directly with i 
peripheral device via the soft I/O routines of 3ISM0. GISMJ 
manages the execution of these operators by the I/O subsystem. 
Each I/O descriptor provides such information as the type of 1/3 
operation requested* source or destination memory addresses* tha 
device which is to execute the operators* and space for result 
information used when control is passed back to the MCP. Certain 
other fields vary with the type of descriptor and contain 
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in format Ion peculiar to its specific function 



Any number of I/O descriptors may be linked together to form a 
single "chain* and "dispatched** in one MCP operation to lessen 
the MCP*s interaction with the I/O subsystem. 



The transformation of logical I/O requests to physics* I/O 
descriptor manipulation is discussed in the Deraand Management 
section of this specification. The discussion below is intended 
to describe the operations performed upon the descriptor after it 
has been transformed* A programmatic description of an I/O 
descriptor is given below* This particular descriptor is typical 
of one which light be constructed for a disk file. 



OEFINE IG.OESC. DECLARATION AS 
DECLARE 



E 


01 DUMMY 


REMAPS 10. 


.DESC 


* 


02 10. RESULT 


WORD 




9 


03 


10. COMPLETE 


BIT 


(13 




P 


03 


10. EXCEPTION 


BIT 


CI) 




9 


03 


10. PACK. NOT. READY 


SIT 


CD 




P 


03 


10. QATA.ECC. ERROR 


8IT 


CI) 




P 


03 


FILLER 


BIT 


CI) 




» 


03 


I Q.MEM. PARITY* ERROR SIT 


Cl> 




P 


03 


10. WHITE. LOCKOUT 


BIT 


CI) 




9 


03 


FILLER 


BIT 


(2) 




P 


03 


10. ADDRESS. PARITY. 


.ERROR 




BIT CD 


9 


03 


10. SECTOR. ADDRESS, 


,£RflOR 




BIT CD 


P 


03 


10. SEEK. TIMEOUT 


SIT 


CI) 




P 


03 


FILLER 


BIT 


(33 




P 


03 


10. THAN SMI SSI ON. PARITY. ERROR 


BIT C13 


9 


03 


10. RESULT. SIT. 17 


SIT 


(1) 




9 


03 


10. PORT. RS 


bit 


(33 




9 


03 


10. CHANNEL. RS 


BIT 


(43 




P 


02 10. LINK 


ADDRESS 




9 


02 I0.QP 


WORD 




9 


03 


10. OP. OP 


8IT 


(3) 




9 


03 


I0.0P.M 


BIT 


(13 




9 


03 


I0.QP.W 


BIT 


CI) 




P 


03 


I0.0P.V 


BIT 


CD 




9 


03 


IO.OP.E 


BIT 


CD 




9 


03 


I0.0P.0 


BIT 


CD 




9 


3 


IO.QP.KMN 


BIT 


C3) 




9 


03 


FILLER 


SIT 


€5) 




9 


3 


I0.0P.P 


SIT 


CD 




9 


03 


FILLER 


SIT 


C33 




9 


03 


IO.OP.U^IT 


BIT 


(43 




P 


02 10. BEGIN 


ADDRESS 




P 


02 I0.ENQ 


ADDRESS 




9 


02 IG.0I5it.AQDRESS 


ADDRESS 




9 


02 10. M. EVENTS 


BIT 


€8) 




P 


03 


10. M. EVENTS. IOC 


BIT 


CD 
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* 03 IQ.M.EVENTS.SIOC BIT (1) 

* 03 FILLER BIT CI) 

* 03 IO.M.£V£NTS*XNT.M BIT (1) 

* 03 10. M. EVENTS. S.INT.SEWT BIT CI) 

* 03 10. M. EVENTS. H. INT. S^NT BIT <1> 

* 03 FILLER BIT <1> 
. 03 IQ. H. EVENTS. IHT.S BIT <1) 

* 02 10. HCP. ID 8IT C16) 

* 02 1Q.FI3 ADDRESS 

* 02 I0.F13.LINK ADDRESS 

* 02 IQ.8ACK.LIMK ADDRESS 

* 02 10. PORT. CHAN SIT 17} 

* 03 10. PORT SIT C3) 

* 03 10. CHANNEL 8IT €4) 

p 02 10. BEEN. THRU. ERROR 3IT <1)#? 

With the exception of the Multi-Line Control used on Data 
Communications configurations* on the 31000 hardware the I/O 
controls have no direct connection with «ain nenory. All dati 

transfers between the controls and memory must go throtgh the 
processor. GISMO is a set of micro-coded routines whose primary 
function is to interface between the HCPs and the actual 
hardware. This allows the HCPs to view the I/O subsystem as an 
I/O processor. The HCP can initiate I/O Descriptors and GISMO 

wi44 handle initiation of the control* data transfer and 
termination. The HCPs can queue several descriptors for 

execution by a control* by property setting the link fields in 
the descriptors* and GISHO will initiate each one in turn. 

User programs make requests to the Micro HCP* and sometimes the 
Micro HCP must ask that the request be kan4ieti by the S.MCP* but 
in either case* the HCP will pass the request to GISMO who in 
turn witl pass it on to the I/O control. 

The I/O subsystem allows fifteen controls or channels tc be 
connected to any machine- After GISMO initiates a control* it 
does not wait for completion of the operation but returns control 
to its caller. Consequently* one* and possibly more operations 
may be in process on the machine at any given tise. At any given 
moment* however* when GISMO is executing it ntay only address one 
control. 

The primary communication between the HCPs and GISMO is throuqn 
the I/O descriptors. The S.HCP wilt initiate I/O operations 

using the DISPATCH S-operator and the M.MCP contains micro-code 
to perform a similar function. This S-operator requires t*o 
parameters* the port and channel of the device being addressed 
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The I/O decsriptor 
fey GISHO for the 



An I/O descriptor is usually located by its "Reference Address*** 
the memory address of the result descriptor field of the I/J 
descriptor. The resutt descriptor field is often referred to as 
the W RS field** or Result Status field. All of the descriptors 
associated with a given control will be linked together in 
memory* by setting 10. LINK to the aieroory address of the PS field 
of the next descriptor. The descriptors are also linked in tha 
reverse direction* using the 10. SACK. LINK field* to facilitate 
adding and deleting descriptors. A link field may not be zero* 
but a descriptor may be linked to itself. 

The Reference Address points to the RS field. Each RS field is 
twenty-four bits in length. The bits in the HS field have 

different meanings at different times. GISHO is most concerned 
with the setting of the bits when the I/O is initiated. The HCPs 
are wore concerned with tf\Q setting of the bits when the I/O is 
complete. When the descriptor is ready for initiation* the RS 

field is formatted as shown in the following diagram. This field 
is usually referred to as the result status field when the 
descriptor is ready for execution or is in process and as j 
result descriptor field when the I/O operation is complete. 



Bits 0-1 - RS Status Bits 



00 - Ready to be Executed 

01 - I/O Currently in Process 

10 - I/O Complete with no Exception 

11 - I/O Complete with Exception 



Bits 2-11 - Gisffio Toggles 



Sits 12-1* 
8i t 15 

Bit 16 

Bits 17-19 

8i ts 20-23 



MCPs ffay not alter any bits in this field if 
ft 5 Status = 01. 

- Port to which this I/O is directed. (Not used) 

- Interrupt requested on I/O Completion. 

- High-Priority interrupt requested on I/O 
Completion. 

- Port to which interrupts are to be sent upon 
I/O Completion (Always Processor Zero). 

- Channel on which I/O is to be oer formed. 
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The leftmost bit of an RS field is always set when the operation 
is complete. Consequently* storing a result descriptor locks the 
descriptor to GISMO. The HCP may lock a descriptor as well* if 
the status field is not 01. Gismo will only initiate "ready" 
descriptors* those whose status bits are equal to 00. When the 
operation is initiated* GISHO sets the status bits to 01. 
GISMO toggles area is used by GISHO when an I/O is in process 
store information which it needs concerning the operation. 



The 
to 



Atf££L I1SL£ 



Another structure associated with peripheral management is the 
channel table. There is one channel table for each port and eacn 
element of the table describes one channel of that port. * h, !; e 

GISMO uses the I/O descriptor to communicate directly with ths 
I/O subsystem* the channel table is a structure for pass'?9 
information between the HCP and GISMO. The channel table 

reflects the status of a particular channel. Certain information 
is passed to GISMO during a "dispatch" operation and is used by 
soft I/O in managing the execution of that operation, 
fields are updated before GISHO passes control back 
which direct the course of action the HCP wilt 
programmatic description is given below: 



Certai n 

to the HCP 
take. a 



DEFINE CHANNEL. TA8LE .QECt A& A TIGN AS # % 
DECLARE 01 DUMMY REMAPS CHANNEL.! ABLE X 



02 CHANNEL. BUSy 
02 CHANNEL .PENDING 
02 CHANNEL.EXCEPTION 

02 CHANNEL. PAUSE 
02 CHANNEL. OWEHRIDE 
02 CHANNEL. EXCHANGE 
02 CHANNEL. OLO.H00E 
02 CHANNEL. INTEGRITY 
02 CHANNEL.NO. HALT 
02 FILLER 
02 CHANNEL. TYPE 



02 CHANNEL .LAST 

02 CHANNEL. EXCHANGE. PC 

03 CHANNEL. EXCHANGE.? 
05 CHANNEL. EXCHANGE. C 

02 CHANNEL. REF.AQ9R 
f % 



BOOLEAN 

BOOLEAN 

BOOLEAN 

BOOLEAN 

BOOLEAN 

BOOLEAN 

BOOLEAN 

BOOLEAN 

BOOLEAN 

BIT C5) 

81 T CU 

TYPE = 

TYPE = 



% 
% 
% 

= 

1 = 
TYPE •= 2 = 
TYPE = 3 = 
flOOLEAN % 
BIT (7) % 
BIT C3) % 
81 T (*) % 
ADDRESS % 



= TAPE* DISK* CAS 



SERIAL 
OISK 
TAPE 
CASSETTE 



DEVICE 
DEVICE 



TYPE EOF DUMP 



DELIMITS CHA^ TABLE 



In the CHANNEL. TABLE* BUSY is set and reset by GISHO only. It is 
set when the control is busy. PENDING is also set and reset by 
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GI5MQ. It is used on tape and disk devices only and it tells 

GI5M0 to continue linking through the head of the q^eue- 
EXCEPTION is used on all devices except tape and disk. It causes 
QISHO to inhibit dispatch operations on the channel until a prior 
exception condition has been handled by the MCP* 

PAUSE is also known as the TIMER bit. It is set by the MCP and 
it never changes. It causes GISHO to issue a dispatch to thi 
channel at each 100 billisecond timer interval and is used to 
implement TEST .AND. WAIT operations on tape and di sic controls. 
This is discussed in more detail later. 

The OVERRIDE bit is used on alt devices and causes GISHO to reset 
BUSY* PENDING and EXCEPTION when a new operation is dispatched. 
It is set by the HCPs and reset by GISMG. Essentially* it causes 
GISHO to override an existing operation with a new operation. 

The EXCHANGE bit is set by the MCP and it never changes. It is 
used on tape and disk controls only and it means that the 
information in EXCHANGE. PC is valid. that there is another 
control connected to this control by a hardware exchange. The 
OLD. MODE bit* also known as the PAUSE bit* is also set by the MCP 
and never changes. It is set for Single-tine Controls and for 
Disk Cartridge Control One. It causes GISHO to pause for 100 
milliseconds when a locked descriptor or a Pause I/O descriptor 
is encountered. If this bit is not set* GISHO will stop in this 
circumstance on these controls- 



The INTEGRITY bit is set by the NCP 
is initialized. It is also used by 
I i n k i in g on t he channel. 



when the channel 
the MCP to stop 



table entry 

GISHO from 



It 

leans 



i s 

of 



The TYPE field is used only by the Dump Analyzer progra 
necessary because the analyzer may have no other 
determining this information. The REF.ADOf* field contains the 
address of the descriptor that is in process on this channel. It 
is considered the head of the queue by GISHO* 



U^MlMiMAU XfiX£BEA££ 



The I/O descriptor contains most of the information GISHO needs 
to accomplish an I/O operation. In the actual ** r **f re 

interface* the OP* BEGIN* END* DISK.AODBESS and ACTUAL. END field* 
are used. The ACTUAL. END field is twenty-four bits in length and 
immediately preceeds the HS field in each descriptor. It is not 
shown in the preceding I/O descriptor diagram. The field- is used 
by GISHO while the operation is in process to store the memory 
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address of the data that is to be transferred to or frc* the 

memory buffer- Hhen the operation is completer ACTUAL. END wilt 

contain the address of the next bit that data would have been 
transferred to or from* 

Each control h able to buffer* or store* a certain amount of 
data to be transferred. The amount varies among the devices. 
For some devices* such as the card reader and line printer* it is 
a full record. For others* the size of the buffer may vary and 
each contoi may contain a portion of the data. Disk control sp 
for example* are equipped with a certain number of 180-byte 
hardware buffers- The amount of data that may be contained in 

the controls and the procedures that GISMO must follow in the 
execution of an operation are fixed when the control is designed 
and do not change afterward. 

£A£S£ £I£LE£ 

The hardware in the processor that is used by GI5HG is the 
Command Register* the Data Register and the Service Request 
level* The Coiraand Register is used to send irforiation to a 
control* the Oata Register to receive from the control and the 
Service Request level indicates that a control needs attention 
from GISMO. 

Host transactions with the control consist of a 

Coramand-Activate/Response-Cosiplete CCA/RC) cycle. Oata cr 

command information is sent out to a control with a CA. Control 
information or data is returned with a RCm 



£RQ££i£3B UQ INSIfil2£II£fi£ 



The processor instructions when GISMO uses to accomplish an 
operation ares 

TEST STATUS 

GISHO requests and the control returns its current status 

count and the device 10. GISMO uses this information to 
decide what to do next. 

TEST & CLE A3 

This operation clears the control. 
TEST SERVICE REQUEST 

GISHO requests* and the processor returns* a mask of aftl 
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channels that are currently requesting service, 

TERMINATE GATA 

This operator is used to terminate data transfer when the 
media* disk and tape for example, has no fixed record sue, 

TRANSFER OUT A 

Moves one or two bytes of data from sesory to the control 
for output to the device. Oata is sent at CA time? the 
control returns its status at RC time. 

TRANSFER OUT 8 

Hoves three bytes of data from memory to the control for 
output to the device* 

TRANSFER IN 

*Joves one* two or three bytes of data frora the control to 
main memory on input operations. The data is sent at RC 
tine* When one or two bytes is transferred* the control 
also sends its status. 

S£MI££ fl££li££I 

The Service Request tevel is a toggle in the processor which is 
settable by any control. It is OR-ed into the "Any Interrupt 
toggle. Each Interpreter* prior to executing an 5-oerator* will 
test the Any Interrupt toggle and, if it is set,, transfer control 
to GISMO instead. GISMO will determine what caused the toggle to 
be set. In this case* it will discover that Service Request is 
r a i s e d . 

It miU then do a JEST SERVICE REQUEST CA/RC cycle. The RC will 
return a ®ask of all controls that are currently requesting 
service. GISMO will select the highest channel from this mask 

and begin handling that control. Conrols are usually in status 
count 11 or 18 when they raise Service Request. This status 
indicates that the control is ready to send a Reference Address 
to GISMO. GISMO acceots the Reference Address and uses it to 

locate I/O descriptor in memory. 

GISMO wiU then do a TEST STATUS CA/RC cycle to detemine what 
service the control is requesting. Once the requested service 
has been performed* and the control 5° '^^er/s requesting 
service* GISMO will again perform a TEST SERVICE REQUEST CA/RC 
cycle. It will continue handling Service Requests from various 
controls until the TEST SERVICE REQUEST returns all zeros. 6ISM0 
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The Status Count returned by a control is the primary weans in 
which GISMQ determines what is to be done next in an I/O 
operation* Operations ssay consist of sending the Op code and 
file address* sending the Reference Address* receiving the 
Reference Address* sending or receiving data and receiving the 
result. Various controls perform these steps in different 
orders. 

All controls begin in Status Count 1 and return to Status Count 1 
after Status Count 23. Each Status value has a particular 
meaning. Sense counts always appear in series together. Ait 
controls begin an operation by going through Status Counts 1 
through 6. A simplified table of the allowable Status Count 
transitions is shown in the table below. 

To send each of the twenty-four bit. fields 0P> DISK. ADDRESS and 
Reference Address* three TRANSFER OUT operations are used* each 
CA/RC sending one byte. For each TRANSFER OUT, the Status 
Counter advances by one. Similarly* to receive either the Result 
Descriptor or the Reference Address* three TRANSFER IN operations 
are used* each CA/RC receiving one byte* 
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Status Count Meaning 





1 

1* Z* 3 

4# 5 p 6 

J* 8* 9 

10 

li> 12* 13 
14 
15 
16 

If 

13* 19* 20 



Control Not Present 

Cleared CInitial) State 

Ready to Receive OP* 8ytes 1* 2 and 3 

Ready to Receive DISK ADDRESS* Bytes 1* Z* 3 

Ready to Receive Reference Address* 8ytes I* 2* i 

Busy CQperation §n process). Froa 10* Controls 
usually go to Status 11 or 18 and raise 
Service Request* 

Ready to Send Reference Address* Bytes 1* 2* 3. 
Ready to Receive Data (output* 
Ready to Send Data (input) 

End of Hardware Suffer - Ready to Send or Receive 
Last 8yte» More Buffers Renain. 

End of Hardware Buffer and Last Suffer. 

Ready to Send Reference Address* Bytes 1> 2* 3. 
Implies that a Result Descriptor is to Follow- 



21* 22* 23 Ready to Send Result Descriptor* Bytes 1* 2* 3» 



Table X, X - Typical Control Status Counts and their Hearing 
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GISHO transfers data to and from the control in one or sore 
iterations* each iteration will involve only one control Duffer, 
For some devices* there is only one buffer and this buffer will 
always contain the full physical record. GISMQ will only perform 
data transfer once per I/O operation for these controls. Other 

controls have physical records of undefined length? for these 
controls* there are usually multiple buffers of fixed length in 
the control and each iteration of GISHO will fit* or eapty one of 
these buffers. 

Whenever Service Request is raised and GISHO is invoked* the 
requesting control will first send the reference address. GISHO 
will then test the control's status. If the control is in Status 
14 or 15* GISHO will begin data transfer. For each operation* 
data transfer will continue until either the controls buffer is 
empty or the ENO address of the I/O descriptor is reached. In 
the first case* the control will have gone to Status 7 after the 
last data char ac tert s) . GISMQ will test its status* see that it 
is in Status 7 and send it the Reference Address* thus completing 
the iteration. In the latter case* on siost controls* GI5H0 will 
send it a TERMINATE command. Soma controls require data transfer 
to continue until the end of the control's buffer. On input* 
GISHO will accept the remaining data from these controls but will 
not store it in memory. On output GISHO will send blanks to 
these controls. 

Oata is always transferred to a control in one* two or three byte 
portions. Most "Serial* devices* such as printers and card 

devices* use one byte transfers* This data transfer is performed 
from a loop within GISHO which consists of a CA/RC cycle* 
transferring one data byte* until the control's buffer is full or 
the ENO address is reached. A buffer full condition is detected 
by the control sending or receiving the last data byte in Status 
Count 16 or 17. 

Many disk and tape controls transfer data two bytes per CA/3C. 
Qisfc input and output is always terminated by GISHO when the END 
address is reached* possibly in the last of multiple disk 
sectors. when the record length is an odd number* GISHO will 
normalize the last byte as required. On output operations* the 
control will pad the remainder of the last buffer Cand hence 
sector) with zeros. 



Tape output* possibly in the last of multiple buffers* is also 
terminated by GISHO when the ENO address is reached. When the 
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physical record size is an odd nunber of characters* GISMO will 
rornalize the last byte for the last CA/«€ cycle. It will send a 
TERMINATE command* followed by a special coisand which will 
indicate w odd character count** to tell the control that the last 
data transfer consisted of one byte only* Tape input operations 
will terminate either when the END address is reached or when tha 
end of the physical record is encountered* which may ba in the 
last of multiple buffers. If the end of the physical record 
occurs and the length of the record is an odd nuiber of 
characters* the control will set a flag in the RC portion of the 
last Ck/Ht cycle* GISMO will then normalize the last byte of the 
record. 

All disfc pacis controls* the 5N he ad-per-tr ack control and all 

phase-encoded tape controls use three byte data transfers. In 

this case only* an exception is made to the general rule that all 

transactions involve one CA and one RC . On these controls* one 

CA may be followed- by one or raore RCs. This is accomplished as 
follows. 

Prior to entering the transfer loop* on input* GI5M0 will use a 
special CA/RC cycle to a sic the control how n^ny butes it has to 
send. It will then initiate the transfer loop with a CA and 

continue it with as many RCs as are required* receiving 
twenty-four bits of data on each RC. For output* GISHO will tell 
the control how many bytes it has to send* It will then initiate 
the transfer loop with a CA command of TRANSFER OUT 8* and 
continue it with as many RCs as are required* sending the data 
out with the RC. 

The I/O subsystem of the 31000 system does not use queues for 1/0 
operations. Using the facilities presented in the preceding* it 
connects all 1/0 descriptors that are directed to the sate 
control* or group of controls connected by an exchange* in a 
circular chain. This atiroinates the necessity of an I/O complete 
interrupt being directed to the WCP* provided the producer of 1/0 
requests* most often a user program* does not produce the 
requests faster than they can be satisfied. In other words* if 
the 1/0 subsystem is completing operations before they are 
actually required by the user* then the user will never need to 
wait on the completion of an I/O request and the MCP will never 
have to suspend the program waiting for such a completion. 

Even if this isn't the case* if the user program is forced to 
wait upon the completion of his 1/0 requests* the aatount of 
processing that must be done to accomplish the suspension and to 
reinstate the program upon completion is minimized using 
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chaining* The processing is limited to only that which is 
concerned with program execution an4 no processing is required to 
tell the I/O subsystem what it should do next. This information 
is already contained in the I/O descriptor* 

For al l devices except tape and disfc* then* the HCP constructs 3 
circular chain of descriptors in memory* GISMO executes the 

requested operations in turn* as each descriptor is unlocked fay 
the MCP. Upon encountering a locked descriptor* GISHO simply 
pauses or stops until the descriptor is unlocked* This wilt 
occur when the user program next executes an I/O request or when 
the file is closed for any reason* If the program must wait upon 
an operation* an I/O complete interrupt is requested* using the 
appropriate bit in the RS field* and the program is suspended 
pending the occurrence of the interrupt* 

The disk I/O subsystem operates somewhat differently from the 
operation fust described* Since each disk I/O descriptor 

contains a disk address field* it is not necssary for the 
operations to execute in any particular order* Various leans are 
provided in the software to prevent any contention problems that 
might arise* It may be noted that these same means are necessary 
on I/O subsystems which utilize queueing instead of chaining. 

Ail I/O descriptors for all disk controls that are connected to 
the system are connected in the same chain. I.f the system is 
equipped with more than one control* then each Channel Table 
entry wilt point to the head of the chain* If GISHQ encounters a 
descriptor which is not ready for execution or which is already 
in process* specified by the first two bits of the RS field being 
set to anything other than 00* it does not stop or pause but 
continues to the next descriptor in the chain. Also* if an 
exception condition occurs* GISHO does not stop or pause as it 
does on other controls* 8oth of these actions are specified by 
the CHANNEL.NQ.HALT bit in the Channel Table. 



Since GISMO continues linking in both of the cases mertionad 
above* it must know when it has examined all of the descriptors 
in the chain. When it has examined all of the descriptors* it 
must stop to free the processor for other execution. To 
accomplish this* the REF.AOOR field in the Channel Table is used 
to mark the beginning of the chain. Wh®n a disk operation is 
dispatched by the MCP* the reference address passed by the 
dispatch is discarded and the REF.AOOR field is used instead. 
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In order to operate properly with dispatch operations occurring 
in an order different from the order of the descriptor I i nk 
fields* GISHO must be able to override stopping when it has been 
through the entire chain once- For example* if descriptors A* 8* 
and C are present in the chain and if 8 is dispatched* GISHO will 
link to and Initiate 8* If* during the time that 8 is in 
process* A is dispatched* GISHO must link past C and the HEF.ADOH 
field and find and initiate A. 

To accomplish this* the PENDING bit in the Channel Table is used. 
This bit is set by a dispatch operation and reset by GISHO. If 
GISHO arrives at the descriptor addressed by the REF.ADOR field 
and if the PENDING bit is set* it does not stop but resets 
PENDING and continues linking. If PENDING is already reset at 
this point* then GISHO stops. 

Since all descriptors for all disk controls are maintained in the 
same chain* GISHO nust be able to recognize descriptors which are 
addressed to controls different frons the one it is handling. 
This is accomplished using the 10. CHANNEL. RS field of the I/O 
descriptor. Upon encountering an unlocked I/O descriptor* GISNO 
compares this field to the channel it is executing upon and if 
the two are not equal* it does not mark the descriptor in process 
but continues linking. 

B151S 1LQ UJKfiLAfiEEfl £££1S2 

When an I/O operation is initiated on a moveable arm disk device 
and the arm is presently positioned to a cylinder different frow 
the one specified in the descriptor* it is necessary to 
reposition the artn to the proper cylinder. This operation is 
known as a "seek*. On the B1000 system* all seek operations are 
implicit* there is no explicit Seek operation in the hardware. 

The MCPs initiate disk I/O operations without regard for the 
current ara position and* if am raovement is required* it is 
accomplished by GISMO* the control and the device without the 
HCP»s participation. The MCP does not know that a seek is being 
performed or required. 

On this system* all seek operations are "overlapped". This isans 
that the arsj of any given drive roay be in fiction sisui taneousl y 
with the arm of any other drivels). Also* the control fay be 
performing data transfer or any other operation while the arsis 
are in notion* 

This is accomplished by the control returning a result descriptor 
with Bit IF* 10. RESULT. BIT. 17* set to zero. £ sssent i all y* this 
informs GISHO that some special action is necessary and that 
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GISMO should not store the result descriptor in memory. In this 
particular case* the control also informs GISMO that the selected 
drive is now seeking* GISHO wilt initiate no further operations 
upon that drive until informed* by the hardware* that the seek 
operation has completed* 

OCC-2 CCartridge) and all disk pack controls notify GISNG that a 
seek operation has completed by raising Service Request while ir 
Status Count I. GISMO will again send the descriptor to the 

control and this time* sfter any required latency period* data 
transfer will occur. OCC-l does not notify GISHO when a seek 

operation has completed but must be "polled" periodically by 
GISMO. The pause tine period for DCC-t* the time between the 

poll operations* is two milliseconds. 

The Oi sk Subsystem Controller C0SC3 offerred on GEM processors 

introduces some exceptions to the statements above. These 

exceptions will be defined in a subsequent version of the 
spec if ication. 

MIL UU £MIMM 

The chaining of I/O descriptors for magnetic tape controls is 
perhaps the most complex of the three basic types. The 
complexity is caused by the fact that tape I/O descriptors 
directed to each separate tape unit must be executed in logical 
sequence and there may be several such units attached to the same 
controi(s). It doesn't matter which unit GISMO addresses next 
but the descriptor that is used to address the unit must be the 
next logical descriptor in the "subchain" for that unit. It is 
therefore necessary to break the channel chain into subchains* 
with one subchain for each physical unit* and to impleaent a 
means of remembering the next logical descriptor that must be 
used within each subchain. 




The MCP* when the system is Clear/Started* constructs a taps 
chain with one Lock descriptor for each unit connected to the 
system. The ACTUAL. END field of a Lock descriptor is not used 
and the LINK field will contain the memory address of the next 
Lock descriptor. The BEGIN and END address fields of the Lock 
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descriptor will contain the address of the TEST* 
descriptor that the MCP uses to monitor the status of 
This is discussed in a later paragraph. 



.NO. WAIT I/O 

each uni t » 



When a file is opened on a tape unit* the MCP changes the BEGIN 
and END address fields in the Lock descriptor. The MCP now 
constructs a subchain for the unit which will consist of one I/O 
descriptor for each buffer requested by the user. The 6ECIN and 
END addresses of the Lock descriptor will be set to the memory 
address of the first physical I/O descriptor in the subchain ani 
the TEST* AMD* WAIT descriptor will be removed from the subchain. 
The BEGIN address field will not be altered from this point until 
the fiie is Closed. The END address will be modified by GISMO 
each time it executes an operation in the subchain* In effect* 
The ENO address field is used to ra-jembar the next logical 
operation that is to be perforned on the unit. 

The LINK fields in each I/O descriptor in the subchain will all 
address the next physical descriptor in the subchain* as they do 
for all other controls* An exception to this is the last 
physical descriptor in the subchain. The LINK field of this 
descriptor will contain the address of the Lock descriptor for 
that unit. This prevent one unit from monopolizing the entire 
control? it insures that GISHO wiil periodically determine if 
there is anything to be done on the other units. 

The REF.ADOR field of the Channel Table entry for a tape chain 
will contain the address of the first Loci' descriptor in the 
chain. Gist©* upon receiving a Dispatch for a tape control* *itt 
discard the Reference Address passsed and start at the address 
provided by the 8EF.A0OR field. GISNO first attempts to lock the 
Lock descriptor by swapping 01 into the first two bits of the RS 
field. If successful* it fetches the address in the ENO field of 
the Lock descriptor and proceeds to that address. If this 
descriptor is unlocked* it begins the operation specified. If 
not* it returns to the Lock descriptor and stores the address* 
which it previously fetched from the END address field back into 
the ENO address field. 



Assume now that the descriptor at the address fetched from the 
END field of the Lock descriptor was unlocked. GISHO begins this 
operation and* assuming that the operation cannot be cospleted 
without some intermediate Service Requests* returns to the Lock 
descriptor and continues linking through the chain* Eventually* 
the control witl raise Service Request and reference the 
initiated descriptor. Upon completion of that descriptor* GISMO 
will store a result and fetch the LINK field of the descriptor. 
It wilt then proceed to the new descriptor and again check to see 
if it is locked. If it is* GISHO returns to the Lock descriptor 
for the unit and stores the new address in the ENO address field. 
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The new descriptor now becomes the next logical descriptor to be 

executed on that unit. In this wanner* GISHQ effectively 

maintains a logical sequence of operations that are to be 
performed on any tape unit* 

It may be noticed from the foregoing that there is no possibility 
of conflict for a unit between two or sore controls connected by 
an exchange* since GISMO first attempts to lock the Lock 
descriptor before proceeding down a subchain. Similarly* the HCP 
must lock the subchain before altering any descriptor in the 
subchain* 
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The HCP attempts to monitor the status of all peripheral devices 
that are attached to the system* To do this* it must remember 
the status of each device and maintain a certain amount of 
information about each. The major portion of the information 
about all of the devices connected is maintained in the I/O 
Assignment Table CIOAT). 



UQ hSUMMUI IMll 



The I/O Assignment Table CIQAT) allows the MCP to keep track of 
all peripheral units except tne system* s SPO and those devices 
associated with data communication. Each unit is identified by 
port* channel* and unit numbers as well as by a symbolic name. 
Various fields reflect the status of the unit (e.g.* AVAILABLE* 
SAVED* REWINDING* LOCKED). A programmatic descriotion is given 
belows 



DEFINE IGAT.SIZE AS #512#* 
DEFINE IQAT.DECLARATION 
DECLARE i OUHMY REMAPS I0AT# 



AS 



02 UNIT. INITIAL 

03 UNIT.HQWR 
03 UNIT.PCO 

04 UNIT. PORT. CHANNEL 
05 UNIT. PORT 
05 UNIT. CHANNEL 
04 FILLER 
04 UNIT .UNIT 
03 UNIT. NAME 
02 UNI T.LA8EL. ADDRESS 
03 FILLER 
03 UNIT. PACK. INFO 
02 UNXT.RS 
02 UNIT. FLAGS 



# XQ I 8 A 


BIT 


C66)* X 


BIT 


C6)* 


8IT 


£12)* % 


SIT 


C7)* % 


BIT 


( 3 } * % 


BIT 


C4>* % 


BOOLEAN* X 


SIT 


C4)* % 


CHAR 15)* 


05K„ 


.ADR* 


SIT 


i 12)* 


ADDRESS* 


ADDRESS** USER 


8ITC36)* 



I A T 



LIMIT REGISTER 
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03 



02 



05 


m 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


3 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UN 


03 


UNIT 


03 


UNIT 


03 


UN 



XT.AVAIi.A3LE 

XT. AVAILABLE. INPUT 

IT. AVAILABLE. OUTPUT 

IT.W A IT. FOR. NO I. READY 

IT.TEST. AND. WAIT 

IT. SAVED 

IT. REWINDING 

IT .EOF. SENSED 

IT. LOCKED 

IT.LA8EL. SENSED 

IT. PRINT. BACKUP 

IT. PURGE 

IT.LGCK.AT.TERN 

XT.TG.8E.SAVE0 

IT.FLUSW 

IT.TAPEF 

XT.OXSKF BOOLEAN* 

XT. STOPPED -BOOLEAN* 

IT. TRANSLATE 

IT. CTRL. CARD. USING 

XT. REMOTE. JOB 

IT. CLOSED 

IT. CLEARED 

.HULTI.FXLE 

-EOT 

IT. TAPE. FILE. STATUS 
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BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

BOOLEAN* 

8G0LEAN*% FLUSH TO EOF 

BOOLEAN* 



BOOLE 

BOOLE 
BOOLE 
BOOLE 
BOOLE 
BOOLE 
BOOLE 
8ITC3 



03 UNIT. TAPE. XCH 

03 UNIT. NO. TRANS. T8LE BOOLEAN 
UNIT. OFFLINE. YET. IN. USE 
03 UNIT. AUDIT 
03 UN IT. RESERVED. BY. A3 
03 UNIT. LABEL. OP 



UNIT. DRIVE. TYPE 
% VALUE 



% 





% 


I 


% 


z 


% 


3 


% 


4 


% 


5 


% 


6 


% 


J 



DCC 1/2/3 

32X203 
32X406 
64X203 
64X406 

N/A 

N/A 

N/A 

N/A 







02 
02 
02 



UNIT. STATUS 

UNIT. TO. BE. POWERED. OFF 
FILLER 



BOOLE 
*ZPC~5 
BOOLE 
BOOLE 
BOOLE 
8ITC3 



9ITC4 
PCi/2 
N/A 
215 

225 

N/A 

207 

205 

20 6 

N/A 
3XT t 
BOOLE 
BITCF 



AN* 

AN* 
AN* 
AN* 

AN* 
AN* 
AN* 
)*% 

% 

% 

% 

X 

% 

X 
AN*% 

AN* I 
AN* 
AN * % 
)*% 
% 
I 
% 
)*% 
DFC 
N/ 
SYS 
N/ 
1C- 
1C- 
1A- 
1A- 
N/ 
15)* 
AN * 
)* 



% 

= NOT RELEVAN 
i = BOVCBEG OF 

2 = B0FC8EG OF 

3 = EOVCEND OF 

4 = EOFCENC OF 

5 = PF3CPR0CESS 

1 = UNDEFINED 
FOR HIS~*ATCHE 

rm ASSIGNED UN 
X DNS AUDIT TA 
AUTO BACKUP 6 
Q=30GEG0X3 ODD 
l=3O0C0OX3 ODD 
2=300600X3 EVEN 

3=aoo400xa even 

DISK ONLY 

1 0FC3 

A N/A 

.*£M 5N 

A N/A 

3 N/A 

4 N/A 

3 N/A 

4 N/A 
A N/A 



TC.ANSn 

VULUHE 
FILE) 
VOLUNE) 
FILE) 

FILE 3LK 

D UNITS 

ITS. 

PE 
.1 

TtfANS 
NO TRANS 

TRANS 
NO TRANS 
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Q2 UNIT. JOB. NUMBER 8ITC1&)* 

02 UNIT, FIB. ADDRESS ADDRESS* 

02 UNIT. U8EL. TYPE BIT C 2 ) * 

X = OMITTED 

% 1 = BURROUGHS 

% Z ~ USASI 

Z 3 ~ INSTALLATION 

02 UNIT.TRAHS.T3LC.I0 8ITCBJ* 2PC-5 TRAIN 10 

02 FILLER WORD*Z PLEASE DO NOT DISTURB 

02 UNIT. TEST. 0E5C BIT < DESCRIPTOR. SIZE)* 

#? % OELIHIT IOAT DEFINE 

The entire IOAT is constructed by the HCP whan the system is 
Clear/Started* During the Clear/Start operation* the HCP directs 
a Test descriptor to each of the controls that are connected to 
the systen* When it discovers a control that may have more than 
one unit connected to it* it sends a Test descriptor to each 
possible unit and nafces one entry in the IOAT for each unit that 
is connected* 

The UNIT.HD^R field in the IOAT will contain the hardviara 
identifier returned by the test descriptor. The following is a 
list of hardware types and pseudo-types that are supported oy the 
HCP* Pseudo-types are used in the device assignment process to 

indicate generic types* such as w any magnetic tape device" which 
would include seven-tracfc* nine-track* phase encoded* NRZ and so 
forth. 
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R 8 S 8 r V 8 d 

80 col READER. PUNCH. PRINTER 

80 cot CARD PUNCH 

Reserved 

FDC 1 

96 cot READER PUNCH PRINTER 

PAPER TAPE READER 

PAPER TAPE READER-1 

PRINTER 

READER SORTER-2 

READER SORTER 

DISK FILE CAny head per track) 



0CG-2# 9PC-1) 



DFC-1 


occ-z 


OCC-1 


OPC-1 


OISK PACK COCC-l* 


DISK (Any disk) 


OFC-3 C5-N) 


96 cot READER 


PAPER TAPE PUNCH 


80 cot CARD READER 


SPO-1 


SPO-2 


TAPE 9 TRK NRZ 


TAPE 7 TRK NRZ 


TAPE PE (9 TRK> 


TAPE (Arty tape! 


TAPE. 9 (Any 9 TRK 


Reserved 


CASSETTE 


LPC-5 


QUEUE FILE 


REMOTE FILE 



tape) 



FILE STMT 



HOWP TYPE 





00 


DATA. RECORDER. 80 


01 


CARD. PUNCH 


02 




OJ 




04 


READER. PUNCH. PR INTER 


05 


PAPER. TAPE. READER 


06 


PAPER. TAPE. READER 


07 


PRINTER 


03 


READER. SORTER. 2 


9 


READER. SORTER 


10 


OISK. FILE 


11 


DISK .FILE. 1 


12 


OISK. CARTRIDGE 


13 


DISK. CARTRIDGE 


14 


GISK.PACK.1G 


15 


DISK. PACK 


16 


OISK 


If 


DI5K.FILE.3 


13 


READER. 96 


19 


PAPER. TAPE. PUNCH 


20 


CARD. READER 


21 




22 


■CRT SPG 


23 


TAPE. 9 


Zk 


TAPE*? 


25 


TAPE.PE 


2 6 


TAPE 


2F 


TAPE. 9 


2 8 




29 


CASSETTE 


30 


PC .5 


?1 


QUEUE 


62 


REHGTE 


65 
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In the table above* the File Statement column (FILE STMT) is for 
use in the HCP* s FILE Control Card and is explained in the 
££i£iUL£~i]fi££alifia£i-.iiJii4Sj(. Generic hardware type numbers are 
not stored in the IGAT- Rather* the actual identifiers returned 

by the hardware are used* 

Mil MiiOQMSS 

Unit mnemonics are also assigned by the HCP during the 
Clear/Start process- These mnemonics allow the operator and the 
HCP to identify devices uniquely* The table below lists the form 
of the mnemonic that will be assigned to the various types of 
devices- 
Card Reader CRx 
Card Punch CPx 
Data Recorders COx 
Printers LPx 
Tape Units. MTx 
Disk <head-per- track) none 
Disk Pack OPx 
Disk Cartridge OCx 
Paper Tape Headers PHx 
Paper Tape Punches PPx 
Reader-Sorters RSx 
Cassettes CSx 
Flexi-Oisk FDx 

All units will be assigned a three-character mnemonic which 
begins with the first two letters listed in the table above, Tha 
third character wilt be unique to the unit. The first unit of 
that type encountered by the HCP during the Clear/Start operation 
is assigned the letter "k m * the second **8 W and so forth. 
Assignment proceeds alphabetically and the mnemonic assigned does 
not change unless the system configuration changes. 

The assigned unit mnemonic is stored in the I0AT in the UNIT. NAME 
field. The entire I0AT is maintained in aeiiGry. To minimize 

storage requir emen ts # some information which relates to the unit 
is not stored in the I0AT but is maintained on disk. File 
Identifiers and any other information which is setdoi used by the 
HCP are stored in an INTERN AL. LABEL field on disk. The disk 
address of this field is maintained in the I0AT i n the 
UNIT. LABEL. ADDRESS field- Information in this field is typically 
updated by the STATUS procedure in the HCP. 

The STATUS procedure is executed whenever the Ready status of an 
unassigned device changes- The HCP is made aware of a status 

change by TEST-AN9.WAIT I/O operators. These operators do not 
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truly wait on a unit status change but this function fs emulated 
by GISHO. 

I&SIiAJMUJtAJI IZfl QE£S4I2S§ 

The MCP roust know when a unit goes from s Not Heady condition to 
a Ready condition so that it can read the label on the media and 
update the XNTERMAL.LA8EL information on disk. It must know when 
a unit changes from Ready to Not Ready so that it can mark the 
unit unavailable and initiate a TEST. AND. WAIT .FOR. BEADY on the 
unit* T£ST» AND. WAIT operations allow the spec if ic at ior of 

certain conditions for completion* such as Test and Wait for 
Ready* !fot Ready* Ready to Transmit* Ready to Receive and so 
forth. GISHO will not consider the operation complete unless the 
specified conditions are met » 

On disk and tape controls* which allow isore than one unit per 
control* we cannot tie up the entire control with a Test and Wait 
operation to one unit- For DCC-2* all disk pack and all taoe 
controls* the PAUSE bit in the Channel Table is used to iapleraent 
a periodic test of all such units* At each 100 millisecond tiner 
interval* GISHO searches through the Channel Table looking for 
entries with this bit set to zero. When such an entry is found* 
GISHO initiates that chain at the address specified by ft£F*AD9R* 
also in the Channel Table. During this execution* GISHO will 
initiate alt Test operations encountered in the chain* If the 

conditions for completion specified in the operator have been 
suet* GISHO wilt store the result descriptor returned by the 
operation and queue an interrupt for the HCP? the MCP always 
requests an interrupt in Test and Wait descriptors. 

The MCP also sets the type field of this 1/0 descriptor* 
I0.NCP.IG* to a value which indicates "Status Change**. In the 
MCP* s I/O Complete procedure* which is invoked only when an 
interrupt is returned frafB an 1/0 operation* the value stored in 
I0.HCP.IG will cause invocation of the MCP's STATUS Procedtre. 



si aims EMZgnmi 

As mentioned previously* the STATUS Procedure is executed only 
when the status of an unassigned peripheral changes. If a 
peripheral is being used by a program and if it goes to a Not 
Ready condition* the situation is handled by the 1/0 Error 
Procedure. When an assigned peripheral goes from Not Ready to 
Ready* no action is required by the MCP since the Test ard Wait 
descriptor executed in this case will have a LINK field set to 
the next logical operation to be performed on the device. 
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Peripheral devices which ar® capable of input operations tsuaity 
have labels written on the media* The MCP is equipped to 

recognize several different label formats on disk and tape 
devices and it expects to read control instructions from all car J 
devices which have input capabilities. Control instructions are 
discussed in the M11M3ZS. J2fiSOii2BSl SJJldS and in Product 
Specification 2219 01*4* U££ SSDiCSl 5lOJ»J* and will not be 
discussed here. Essentially* when a card device becomes Ready 
for input purposes* the Status Procedure reads the first card and 
control is passed to the Control Card Procedure. 



On disk and tape devices* when a unit becomes Ready* the Status 
Procedure attempts to read a label from the media. The following 
is a description of the various label formats* on disk and tape 
devices* the MCP is capable of recognizing. 



QI£fi JflSfllJEIfiAIIflfl z £i£JS LAS£LS 



Every disk pack* disk cartridge* or head-per-track sub-syste® is 
identified by a standard -ANSI" pack label. This pack label, 

written in EBCDIC CS bit code)* is two pack sectors long C360 
bytes)* and occupies the first two sectors on a pack* I.E.* 
cylinder 0* track 0* sectors and 1* Sector contains pack 
identification information and sector 1 is reserved for future 
implementation of pack security procedures. A or ogr amnatic 

description is given below* 



DEFINE PACK. LABEL-DECLARATION AS #* 
DECLARE 01 DUHftY REHAPS PACK.LABEL* 



02 

02 
02 

02 



02 



02 
02 
02 
02 



02 
02 
02 
02 



PL.V0L1 
PL. SERIAL. NO 
PL. ACCESS .CODE 
PL. 10 

03 PL. NAME 

03 FILLER 
PL. SYS TEH. INTERCHANGE 



PL. CODE 
FILLER 
PL. OWNER. 10 
PL. TYPE 



PL. CONTINUE 
FILLER 

PL. INT 
PL.VGL2 



CHAR 

CHAR 
CHAR 
CHAR 
CHAR 
CHAR 
CHAR 



CHAR 
CHAR 
CHAR 
CHAR 



CHAR 
CHAR 
CHAR 
CHAR 



€43 

C6) 

CD 

CI/) 

CIO) 

i7) 

(2) 



CI) 
C6) 
U4) 
CD 



CD 

C26) 
CD 



"V0L1" 

SERIAL CCAN) 
ACCESS CODE 
PACK 10 



NUMBER 



SYSTEM INTERCHANGE/COO' 
00 = INTERCHANGE 
17 = 31G00 INTERNAL 
35 = 93500 INTERNAL 
ETC* ETC* ETC 

PACK COOE 03 = SCRATCH 



T = RESTRICTED PACK 
"U" = USER PACK 
*S* = SYSTEM. PACK 
CONTINUATION FLAG *C» 



, vaL2 w 
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* 02 PL.DATE.INtTIALIZEO CHAR C5) % 

* 02 PL. INIT. SYSTEM CHAR C6) % INITIALIZING SYSTEM 
02 PL. DISK. DIRECTORY CHAR CS) X DIRECTORY ADDRESS 

02 PL. MASTER. AVAIL CHAR <8) % MASTER AVAILABLE TA8LE 

* 02 PL. DISK. AVAILABLE CHAR C8> % WORKING AVAILABLE TABLf 

* 02 PL. INTEGRITY CHAR (13 X = NORMAL 

% 1 = RECOVERY REQUIRED 

, 02 PL. ERROR. COUNT CHAR C6> X 

* 02 PL.SECTQRS-XD CHAR C6) % REMOVED SECTORS 

* 02 PL. TEMP. f A8LE CHAR (8> % TEMP TABLE LINK 

* 02 PL. PCD CHAR <3> % LAST PORT, CHAN* DRIVE 

* 02 PL. ASSIGNED. TQ.8PS CHAR C6) % BASE PACK SERIAL NUMBER 

In the case of disk devices* additional inf ornat ion* beyond tftat 
which can be stored in the IQAT* is required by the MCP for 
proper operation. The STATUS Procedure and others maintain this 
information In a reserved area in Bemory known as the Pacfr 
Information Table CPACK.INFO). 

The pacfr information table is an MCP maintained linked fist of 
all user disk paefcs and cartridges currently on line. It 
contains such information as the nam®? serial number, hardware 
unit* nunber of users, and addresses of the disk directory* 
available table* and temporary table. This structure allows a 
pack or cartridge to be externally referenced by nate. A 
programmatic description is given below: 

DEFINE PACK. INFG. DECLARATION AS #X 
DECLARE 01 DUMMY REMAPS PACK. INFO* 
02 P. NAME NAME* 

02 P. SERIAL. NO WORD* 

02 P. DISK. DIRECTORY DSK.AOR* 
02 P. DISK. AVAILABLE QSK.AGR* 
02 P. TEMP. TABLE DSK.AOR* 

02 P.UNIT.NAME CHAR C6I* 

02 P. PCD 8IT C125* 

03 P. PORT. CHAN BIT €7)* 
3 FILLER BIT CD* 

03 P. DRIVE. NO SIT t4>* 
02 P. NO. USERS SIT €8), 

02 P. NO. NPF. USERS BIT <8J* 
02 P. TO* BE. POWERED. GOWN BOOLEAN* 

0? P. RESTRICTED BIT (3)* X = SYSTEM RESOURCE PACK 

% I = RESTRICTED 
% 2 = UNRESTRICTED USER 
% 3 = INTERCHAMQE 
02 P. CONTINUE BOOLEAN* X 1 = CONTINUATION PACK 

02 P.SCRATCH BOOLEAN* t I = SCRATCH PACK 



02 


P. FULL 


02 


P»XC 


02 


P»ASSIGN£D.T0 


02 


P. SACK. LINK 


02 


P.LINK 
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BOOLEAN* % .1 = fcG MORE AVL DISK 

BOOLEAN* 2PACK HAS UNDERGONE XC 
8PS WORO* % ASSIGNED TO 8ASE PACK * 

AOORESS* 

address; 
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MCP II includes the capability to create and recognize tho 
different forms of magnetic tape labels. The standard label 
format for the 81000 system will conform to that specified in the 
publication entitled "The American National Standard Magnetic 
Tape Labels for Information Exchange* which is dated 1969 and 
published by the American National Standards Institute* Inc. 
(ANSII)- These labels stq commonly known as "ANSII* Version I" 
labels* It should be noted that "standard label format" for the 
system means that any program which requests standard labels in 
its file declaration will cause ANSI! labels to be written when 
the file is assigned to Magnetic tape* and the file is opened 
output* Users are allowed to create the label in ASCII if they 

so desire. 



ANSII labels as implemented on the 81000 system contain several 
deviations from the standard as presented by the ANSII documents. 
The deviations are necessary in order to insure that we are 
compatible with the 86700 system* The most noteworthy deviation 
is the recording mode of the label itself? it is written in 

EBCDIC character code unless ASCII is specifically requested via 
the "SN" command* 



ANSII label format* as implemented* consists of three physical 
blocks on the tape* followed by a tape mark. The first of the 
three blocks is known as the Volume Header. A pr ogr ammat ic 

description is presented below. 



01 VOLUME. HEADER 

02 FILLER CHARACTERS) 

XThis field will always contain "VOL!** 
02 VOLUME. ID ' CHAHACTERC6) 

02 ACCESSA8ILITY CHARACTER*!) 

%This field is not used by the 81000 
02 RFS %This field is reserved in the ANSII Standard. It is 
%being used as follows by the 81000 and the 86700. 
03 MULTI.FILE.IO CHAR ACTERC 1?) 

% "0" if there is no HFIQ 
% "X0" I f Scratch 
% -BACKUP" if Backup 
03 SYS*SYH90L CHARACTERS) 
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X Will contain n t7 n if created on 81000 
03 TAPE. TYPE CHARACTERS) 

% = Scratch 
% 1 = User 
% 2 = Backup 
X 3 = Library 
03 FILLER CHARACTERS) 

02 OWNER. 10 CHARACTERS*) 

% This field is not currently usable on the 81000 systei 
02 FILLER CHARACTERC28) 

02 VERSION CHARACTERS) 

X Will contain "1" until such time as the label fortat is 
% changed 

The second of the three physical blocks is known as "Header One". 
The for flat is also used for End-of-File and End-of -Vol urn e. A 

programmatic description is given below. 

01 HEA9ER1. DECLARATION 

02 FILLER CHARACTERS) 

% Hay contain -HRD!** "E0F1"* or w £0¥l" 
02 FILE. ID CHARACTERC17) 

02 FILE. SET. 10 CHARACTERS) 

% This field wilt contain the first six characters from 

X the MFIO field in the VOL! block 
02 FILE.SECTION.Na CHARACTERS) 

% Used for Reel number by 86700 and 81000 
02 FILE.SEQ.NO 

% Ordinal number of 
02 GENERATION.NO 
02 GENERATION.VERSION.NO 
02 CREATION. DATE 
02 EXPIRATION. DATE 
02 ACCE5SA8ILITY 
02 BLOCK. COUNT 

% Zero if this is a 
02 SYSTEM. CODE 
02 FILLER 

The third physical block is known as "Header Two". It is also 
used at End-of-File and End-of -Voluae. Its format is shown 

bel ows 



01 HEA0ER2. DECLARATION 

02 FILLER CHARACTERS) 

% Hay contain W HDR2 W * *E0FZ w » or "EQV2" 
02 RECORD. FORMAT CHARACTERCi) 

% F = Fixed 

% tf = Variable 

X S = Spanned CNot yet implemented by any Burroughs system) 



CHARACTERS) 






the fi le wi thi n 


a Multi-File 


CHARACTERS) 


X 


Unused 


CHARACTERS) 


% 


Unused 


CHARACTERS) 


% 


bYYCDO 


CHARACTERS) 


% 


bYYCOO 


CHARACTERCI) 


% 


Unused 


CHARACTERS) 






Header .One block 


CHARACTERC13] 


) % -817QG* 


CHARACTERS) 
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X 


U = Undefined 




02 


SLOCK, LENGTH 


CHARACTERC5) 


02 


RECORD. LENGTH 


CHARACTERS) 


02 


RES* 


*.5Y$TEN<.USE 


CHARACTERC35) 




OS 


DENSITY 
% = > 800 
% 1 = > 556 
X 2 = > 200 
X 3 * > 1600 


CHARACT ERtl) 




03 


SENTINAL 


CHARACTERS) % 




03 


PARITY 


CHARACTERS) 






X = Cven? 1 = 


Odd 




03 


EXT. FORM 


CHARACTERS) 






X = Unspecified 






% 1 = Binary 








X 2 = ASCII 








% 3 = BCL 








X 4 = EBCDIC 






03 


FILLER 


CHARACTERC31) 


02 


BUFFER. OFFSET 


CHARACTERC2) X 


02 


FILLER 


CHARACTERC28) 



Unused 



Unused 



As mentioned in a prior paragraph* the HCP writes ANSII Format 
labels on tapes whenever a file is opened output and the 
LABEL. TYPE field in the FPB is set to wo. If the user kishes 
to continue writing the old Burroughs format labels* he tust 
modify this field in all of the files in his programs. This may 
be accomplished by r econpitati on * by the use of a File Attribute 
communicate operation within the program* by the use of the 
HODIFY control instruction or by the use of a FILE card when the 
program is executed. Presently valid values for the LABEL. TYPE 
field are: 

= ANSII 

1 = Unlabel led 
Z = Burroughs 

ANSII Labels* though they are written when the file is opened 
output* are actually created on all magnetic tapes prior to that 
time. A keyboard message has been imp! esnen tad in the MCP for 
purposes of creating the initial ANSII label on all tapes. The 
mnemonic of the message is W 5N* which used to be an acronyu for 
Serial Number. The syntax for SN is: 

SN <unit mnemonic> <vol ume-i dent i f i er > I ASCII I 

<Volune identifier^ may consist of one to six alphanumeric 
characters and is inserted in the VOLUHE.IO field of the VOLI 
block of the label which is created. This operation is* for 
conversational purposes* known as "initializing* the tape. All 
tapes and cassettes must be initialized on the 61000 before the 



5-ZJ 



BURROUGHS CORPORATION 
COMPUTER SY5TEMS GROUP 
SANTA BARBARA PLANT 



COMPANY CONFIDENTIAL 

81000 MCP II 

P. 5. 2212 5462 IE) 



MCP will consider thetis scratch* This applies to seven-tc sefc* as 
well as a€l versions of nine- track tapes* 

The <voluroe identifier> keyed in will regain on the tape until 
the tape is re-lni ti aiized* The tape may be purged at any tiwe* 
provided the AN5II label is still intact on the tape* Tapes 
which have Burroughs labels on them must be re-initialized and 
may not be purged. Purging* hers* implies the use of the VG" 
keyboard lessage. Similarly* unlabetied tapes may not be purged* 
but may be r e- ini t iali ed* The <volune identifier^ is now part of 
the output of the **QL W fnessage. The presence of the reserved 
word ASCII in an SN statement causes the label to be written in 
ASCII character codes* 




DEFINE STANQARB.LABEL. DECLARATION AS $ X 

L. LABEL. RECORD X 

» LABEL 



DECLARE 01 GUMMY 
* 02 L. LABEL 

L.MFIG 

L.Z1 

L.I0 

L * REEL 

L.0W 

l.cycle 

L.PIO 
L.S 

L.ec 

L.RC 

l.pb 

L. SERIAL 
L-SYSTEM 

L.8UFSI2E 

03 L.SSIZE 

03 L.RSIZE 

02 L.RECSIZE 

02 L.MOQE 



•f 



02 

02 
02 
02 
02 
02 
02 
02 
02 
02 
02 
02 
02 
02 



REMAPS 
CHAR 

CHAR 

CHAR 

CHAR 

CHAR 

CHAR 

CHAR 

C H AR 

CHAR 

CHAR 

CHAR 

CHAR 

CHAR 

CHAR 

CHARCa) 

8ITC2A) 

BITC24) 

CHARC83 

CHARO) 



19) 
C7) 
tl) 
€73 
<3) 
<53 
(23 
15) 
C13 
C53 
<7) 
<1) 
C5) 
C53 



0* 



DATE WRITTEN 

PURGE DATE 
5ENTINNEL CI 
BLOCK COUNT 
RECORD COUNT 
PRINT BACKUP FLAG 
SERIAL NUMBER 
CREATING SYSTEM 
NEW FORMAT DECIMAL 

FORMAT 

FORMAT 

FORMAT 

FORMAT 
FILE 



= EMO-OF-REEL) 



BLOCK SIZE 



OLD 
OLD 

NEW 
NEW 
TAPE 



BINARY 
BINARY 
DECIMAL 



RECQRO 



RECORDING MODE 



SIZE 

FOR 



All labels 
8egi nning 



on the §1000 systeia are written in odd parity. 
with the 4»2 release of the software* tape (parks ara 



BURROUGHS CORPORATION COHPANY CONFIDENTIAL 

COMPUTER SYSTEMS GROUP 31000 HCP II 

SANTA BARBARA PLANT P.S. 2212 5*62 {£) 

written in even parity* except where prohibited by the control. 

This was done as an accomodation to the 8300 system* which can 

read only seven-track tape and cannot recognize tape marks which 
ar e wr i t te n i n odd p ar i t y * 

MCPII wiii write tapesarfcs and ending labels on any output 
labeled tape that is not at 80T when a Clear/Start is done. This 
wilt allow the user to read that tape and recover the data. 
There is one restriction. If the tape is to be read in reverse* 
the user must specify blocking information* 

ANSII labels are also written as the standard label on 
seven-track tape- Hhen this is done* the labels are written with 
translation to SCL. Burroughs labels* when written to 

seven-track tape* are written in odd parity with the EBCDIC/9CL 

translator enabled* 

The STATUS Procedure makes all possible attempts to recognize a 
label when a tape unit becomes Ready. On seven-track tape* 

particularly* there are several different variations of parity 
and recording mode that may have been used to create the tape. 
Seven-track tape can be written with or without character 
translation from EBCDIC to BCL. The HCP will attempt to read 
tape labels with all possible variations before giving up. 

when the NCP cannot recognize a label* the unit is considered 
available for input purposes if the tape does not have a Write 
Ri ng in it* In this case* it must be manually assigned to a 

program by the operator* either when the program requests tha 
file or when the Job is executed. If the tape does certain 3 
Write Ring* it must be initialized* using the SN instruction 
decsribed above. Only when the tape has a Write Ring and 

contains a valid ANSI label indicating '•Scratch** is it considered 
available for output purposes automatically by the HCP. 

It is also the responsibility of the STATUS Procedure to record 
the other information returned by the Test 1/0 operation. This 

information is crucial to the proper operation of the tana 
subsystem. In particular* if the system is equipped t*ith s 
PE/NRZ exchange* the operation of the STATUS Procedure when a 
unit becomes Ready is as described below. 
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With the Inclusion of the M4/M5 HEC supplied by the Westlaka 
Plant and described by P.5- #2047 4490* it is possible for a 
tape unit to operate In either Phase Encoded iPE) or Non-Return 
to Zero iHHI} recording mode. This can only be accomplished on 
the 31000 hardware by connecting one N«Z control and one PE 
control to the HEC. The NHZ control is designated MTC-2 and the 
PE control is designated MTC-4. A tape subsystem so connected is 
spoken of as an exchange subsystem by hardware personnel. 
According to the software definition of a subsystem* all controls 
in the subsystem must be identical. The code in the I/O driver 
which interfaces to MTC-2 is distinctly different from that which 
interfaces with MTC-4* A request for a unit which is operating 
in the HH1 mode can oniy be handled by MTC-2. 

To solve this problem* considerable coding has been incorporated 
in the MCP. The problem has been rectified in the most efficient 
manner possible* however. Two separate chains of descriptor s# 
one for each control* sre constructed by the MCP at Clear/Start 
time. The two chains are maintained by the MCP dynamicall y* frow 
that point. 



Recording mode information is supplied by the test operator and 
actually is returned as tha density field in the result 



descriptor. A density selection 

indicates that the unit has been 
phase-encoded recording mode and that 
unit should be in the MTC-4 chain 
subchain for the unit is not in the 
move the entire subchain to the proper 



of 1600 bpi* for example* 

selected to be ir the 
the I/O descriptors for tha 
of descriptors. If the 

proper chain* the MCP will 

chain. The movement of 



the subchain is only attempted when the unit is not in use* of 
course. Selecting a different density white the unit is being 
used constitutes an error on the part of the operator. Tha 
operator is notified of the error and the program is allowed to 
continue processing only when the proper density has been 
selected on the unit. 



This solution is only possible if both controls are capable of 
reporting recording density properly, MTC-2 can report the fact 
that a unit is selected to be in the 1600 bpi density. 
Similarly* MTC-4 is able to report the fact that a unit is in the 
800 bpi density. Oensity information is commonly used by the MCP 
only when a unit goes from a not-ready state to a ready state. 
The movement of the subchain is therefore performed by the MC? 
status routine when the unit becomes ready. 



Unit mnemonics are not affected 
exchange. A unit selected as MTA* 



by the presence of a PZfHHZ 
for example* will always be 
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known as HTA* regardless of which chain contains 
which density is selected by the operator* 



Its subchain* or 



Que to differences in the unit numbering scheme between HTC-2 and 
HTC-4* there can be no sore than eight wagnetic tape units 
connected to a PE/NRZ tape subsystem- This capability is not 
available on any version of the software prior to the 5.1 release 
ver sion. 
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A File is a group of related records. Files are of central 

importance in the I/O Subsystem since effectively all of the 
communication between user programs and the subsystem is 
accomplished through files. 



The 81000 Operating System supports three . di fferent file types or 
structures* exclusive of Oata Hanagement System structures* *hich 
correspond roughly to those file types defined in the ANSI * 7k 
COBOL Language* In that language* these types are called 
Sequential* Relative and Indexed Sequential. Sequential and 
Indexed Sequential files* in COBOL* can both be accessed in a 
random manner and the use of the word "Sequent ial* tends to add 
confusion. In this document* the three types will be refferred 
to as Conventional Files* Relative Files and Indexed Files. 



S2MOII0ML EILE5 



\y^<nr A ** 



j 



The basic definition of Conventional file structures is found in 
the COBOL *68 Language* though many functions have been added to 
the basic definition. To a program* a file represents a large 
collection of ordered data that exists apart from the program. 
The program needs to interact with parts of that data from time 
to time and the I/O Subsystem lakes this interaction possible. 
The I/O Subsystem moves the data into and out of user working 
areas in sain memory* to which the program has access. 

The unit of data moved into and out of the user's working area is 
the record* Jhe record is considered* by the I/O Subsystem* to 
be a string of bits* which the user program will probably group 
into characters or words in some manner* but the I/O Subsystem 
deals only with entire records and delivers and receives one 
record at a time to and from the user program. 



as seen by the user program. The 
length or they may be of variable 
must be declared by the program or 
or exist in an accessible fcr» in 
in the information which the HCP 
maintains about the file. lf..Jth & record length is va riable* then 
the 1 e n g t h__°_l e a c n r e c °? d must e x 1st in that recorlfT" in "the first 
four character positions* 



A file has some structure 
records may be all of the same 
length. Length information 

contained in the record itself 
the physical file or exist 
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The fiie> as it is stored on some recording medium* is often 
refferred to as a physical file* A physical file may have soae 
additional elements of structure. It may contain blocks. * 

block Is a group of physically contiguous records which are 
transferred to and from the physical medium as a group. The 

storage device itself may impose some structure upon the file. 
As discussd previously* data is transferred to disk in 1440-bit 
increments. A block of records to be written to disk must 

therefore total some integer multiple of 1440 bits* The dis* 

itself may be used to store many disjoint physical files. To 
minimize storage availability problems* the MCP allows disk files 
to be broken into "areas** each of which will contain room for a 
specified number of blocks. This is described in more detail 
later* 

The physical file inherits many of its properties from the 
logical file declared by the user program which creates it* When 
the user programmer declares a logical file* the compiler 
generates a File Parameter Slock which contains the specified 
values for the various attributes of the file. File Parameter 
Blocks (FPBsJ are defined In Section 2 of this specification. 
The MCP* and more specifically the OPEN procedure* converts the 
attributes specified by the user to an actual physical file. 
More attributes are added to the physical file when it is 
assigned to a device. 

Any file nay be described by its attributes- File attributes are 
systems control parameters which are used by the I/O Subsystem. 
The attributes contain alt of the information the subsystem needs 
when it connects a physical file to a logical file declared in a 
user program and when it controls the access to that physical 
file* 

Mn ^ r nf tha attributes _ ass oci ated with an y file are contained in 
the File Parameter Block CFP83 for t hat file* Certainly* the FPfl 
is the storage medium for the attributes that are declared by the^ 
user and generated by the compiler. Additional attributes will^? 
be obtained when the file is opened and assigned to a device. > 
When a file is open* its attributes may be stored in the FP8* the^ 
File Information Block <FI3>* t^%e Disk File Header CDFH) and the! 
I/O Assignmment Table CIOAT>. All of these structures have been/ 
presented previously. 

Beginning with the 3.0 version of the MCP* a communicate 
operation was added to allow user programs to dynamically modify 
selected attributes of a file. In subsequent versions of the 
MCP* the list of modifiable attribtes has been expanded. The 

File Attribute communicate operation is described in the Demand 
Management section of this document. 
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Alt names associated with files 

of ten characters in length* 

will be truncated to the first ten. 

of the FP8 presented in Section 2 

first field in the EPS* FP8.FXLC.NAME 

file. "Internal* 1 * in this case* 

program* This is the name which appears in the File Declaration 

of the user program and the name which the progr saner uses in all 

references to the file within the program* 



on the 81000MCP may be a ffaximuw 
Na vies in excess of ten characters 
Looking at the description 
of this specification* the 
is the internal nane of the 
means internal to the user 



The next three name fields in the EPS provide the "File 
Identifier* for NCP purposes. Ail physical files introduced to 
the system may have one or two names. Files assigned to disk 
pack may have a third name which will correspond to the pack 
natie* the name contained in the pack label. 



If a file 

FP B*MttLTI*£XLf 

bt ank s, 

ID** and is only 



jiajie only* that nana is stored in 



_ _ tii£_ field 

10 a nd the field FP8. FILE- 10 should be filled with 
FPB«HULTX«FILE.ID is often referred to as the "Family 
important if the file is assigned to disk or 
tape. If a file has two names* the second nam® is stored in the 
FP8.FILE.ID field. 



The assignment of physical files to logical files is discussed in 
the Demand Management Section of this specification in the 
description of the OPEN codiiinlcate operation. Stated in its 
simplest form* the HCP attempts to associate one or two naaes 
with each device that is connected to the systea and that is 
capable of input operations and to match this external name to 
the File Identifier specified In an FP8 when a user OPEMs a file. 
On output files* the MCP simply attempts to assign an available 
device of the requested hardware type. 



There are two exceptions to the statements in the preceding 
paragraph. When an output file is directed to Printer or Punch 
devices* the output data may be actually stored on disk for later 
retrieval. Such files are known as Backup Files and ara 
discussed later. Input card files' nay be loaded to disk files 

prior to the time they are required by a program. When the 

program then requests the card file* HCP raay automatical I y 
substitute the previously loaded disk files. This is known as 
the Psuedo-Reader facility and is discussed in Product 
Specification 2222 2265* iIiI££3£i2£l!iIlL« 
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It is the HCP* s responsibil t iy to convert a logical disk file as 
declared in a user program* to an actual physical disk file. 
This can only occur by a program opening a new disk file* where 
"new" in this context specifies that the program intends to 
create a file and the physical disk files that are currently 
known to the system are of no concern to the user. 



Except in the case of Multi-Pack files* files that extend over 
more than one physical pack. or cartridge* a new file can only 
become a permanent file that exists when the program is no longer 
executing by the same user doing a close operation on the file 
and specifying in the CLOSE communicate operator that the file is 
to become permanent. This implies that the file identifier is to 
be entered in the disk directory and remembered by the HCP 
forever. This also Implies that the 
by that file is to be used for 
various user manipulations that may 
utilizing a logical file with the 
Close operation is also described 
Management section of this specification* Basically* the Open 
and Close operations both obey the rules presented in the 
definition of the CG30L Language. 



disk storage space occupied 
no other purpose except the 
occur within that file* 
same File Identifier. Tha 
in detail in the Demand 



£JiX.SI£AL J21SJS £U£5 



In order to manage all of the available storage space on a disk 
device* the HCP must maintain tables which tell it the storage 
locations that are available for use* the names of the files that 
are already stored on the disk and the physical characteristics 
of those files. 
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There are three tables* each wi th the same format* that are used 
by the HCP to allocate disk space. The master available table is 
a non-expandable table of thre^e contiguous segments beginning at 
the second sector on disk. It contains a list of all unusable 
segments which have been *XD-ed w by the operator. The working 
available table is a 10-segment table beginning at the 47th di*ik 
segment. It contains a list of all available or unused space on 
disk and is expandable as needed. The temporary table is five 
contiguous segments and contains a list of all segments in use 
but not reflected in the disk directory. This expandable table 
begins at the 57th sector. At Clear/Start time* all sectors in 
the temporary table ate returned to the available table- A 

programmatic description is given below? 
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DEFINE 

DISK. AVAILABLE 
DECLARE 

01 QUWMY REMAPS DISK 
02 A¥L. FOR. LINK 
02 AVL.8ACK.LI&K 
02 AVL.SELF 
02 FILLER 
02 AVL.BLQCKt22>* 
03 A¥L. ADDRESS 
03 AVL. LENGTH 



DECLARATION A5# 



■ AVAILA3LE 81 TCSEG.5 IZE) * 
OSS- ADR* 
OSK'.ADAf 
QSK*ADR* 
8ITC4)* 

Q5K..ADR* 

woro?#; 



FILE i£££53 MQ IZZEllZlZkll&U 



The disk directory is the structure which catalogues and points 
to ail files on disk. Each entry contains the file's naie* tyoe* 
and Disk File Header C0FH5 address. The directory is a two-level 
structure containing a urinary or "waster 1 * directory and a 
secondary directory. The master directory is created at Cold 

Start as 16 contiguous disk sectors beginning at sector 31. Each 
sector contains entries for eleven files. As each sector is 
filled* another disk segment is allocated and linked to the 
filled sector. If a file has two names* the primary nase 

(Hut ti -File IDen ti f i ca t i on) is placed in the master directory 
with a pointer to a secondary directory* where all the files with 
that HFIO are listed. The secondary directory is structured and 
linked in the same fashion as the master directory. A 

programmatic description is given below: 



DECLARE 01 DIRECTORY REMAPS 8ASE* 

02 DISK. SUCCESSOR 

02 DISK. PREDECESSOR 

02 DISK. SELF 

2 FILLER 

02 DISK.NA8E 

02 DISK. ADDRESS 

02 DISK. FILE. TYPE 

02 FILLER 



OSK.ADR* 
QSK.AQR* 
OSK.ADR* 
BIT C125* 
NAHE* 
OSK.ADR* 
8IT €4)* 
BIT C 1200)? 



% 11 ENTRY PER SEG 



T he Disk File Header <0FH> is a variable-length header rec o r d » 
the size of which is dependent upon the number of declared areas 
in the file and is computed as follows: 



540-BITS ♦ C36-SITS * KUHBER-GF-AREA5) 
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The OFH is never less than 1440 bits nor greater than 4320 bits 
on "disk* It lists the phy__sj_cal characteristics of the file 

including its file type and the , iTsF a d 3F¥ s T~for~]e a c h area • The 
following file types are recognized by the HCP. 



LOG 
DIRECTORY 

CONTROL DECK 
8ACKUP PRINT 
BACKUP PUNCH 

OUWPFILE 
INTERPRETER 
CQOE FILE 
DATA FILE 
VARIABLE LENGTH 
INTRINSIC FILE 



RECGRO OftTA FILE 



MM £IL£ lB£BII£I£AIIiaJ« 



As di sc 
str uctur 
var i abl e 

the file 
a disk f 
The head 
Th ere w 



usse 
es 

-ten 
and 
He 
er i 
Hi 



i n__jLgj|or 
sane co 

covered 
batons 



in a 



d previously* Disk File Headers CDFH) are the 
used to identify a file on disk. It is a 

gth record which describes the physical attributes of 
contains pointers to each "area" of the file. When 
is "opened** a copy of the OFH is copied Into aenory. 
n memory points to the header on disk and vice versa* 

never be J gj>r e_ , jha n ? ne C0 P_Y ?.f.JM* e nea ^©t_ f or a fi*« 

a ny t i jse_. H u i t fpl e "u s er s of the file will use the 

of the header. Haintenance of disk file headers is 

nether section* A prograransat ic description is given 
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DEFINE FILE. HEADER. DECLARATION AS #Z 

FH.HAP (FILE. HEADER >#* 
FH.MAPtFILE. HEADER) AS %% 
OECLARE 01 DUMMY REMAPS FILE .HEADER* % 



02 FH. USERS. RANDOM 

02 FH.NEWFILE 

02 FILLER 

02 FH. FILE. KIND 

02 FH.SELF 

02 FH. NO. USERS 

02 FH. USERS. OPEN. OUT 

02 FH. OPEN-TYPE 

02 FH.FILE.TVPE 

02 FH. PERMANENT 

02 FH. J08. WAITING. ON 

02 FILLER 



8ITCS>*% 

8ITC1)»<X 

8ITC7)* 

8ITC8)* 

DSK.ADR* 
BIT id)* 
BIT U>* 
BIT {*>*> 
BIT tk), 
BIT C4)* 
• CLOSE BOOLEAN* 

B.ITC93* % DON'T 



FORMERLY FH.C0RE.A00R 

CLEARED WHEN NEW FILE IS FILED 



USE UNTILL 1977 
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02 ' FH.HDR.SIZE 

02 FH.NQ. USERS. LOCK 

X NO. USERS WHO 
02 FH .RECORD* SIZE 
02 FILLER 
02 FH.RCDS. BLOCK 
02 FH. SLOCKS. AREA 
02 FH.SEGS.AREA 
02 FH. AREAS. RQST 
02 FH.AREA.CTR 
02 FH. EOF. POINTER 
02 FILLER 
02 FH.8PS.N0 
02 FH.8L0CK. COUNT 
02 FH.FGRMAT 
02 FH.HPF 
02 FILLER 
02 FH. CREATE. TIME 
02 FILLER 
02 FH. USER. INFO 
02 FH. SAtfE.FACTOR 
02 FH. CREATION. DATE 
02 FH. ACCESS. DATE 
02 FH.SER.NO 
02 FH.MPF. AODR 
02 FILLER 

02 FH.UPOATE. VERSION 
02 FH.OMS.WRITE.CONTRO 
03 FH.OMS.TO.BE.W 

03 FH. QMS. CONTROL 
02 FH.VERSI3N 

02 FH.PR0TECT10N 
02 FH. PROTECTION. 10 
02 FILLER 

02 FH. AREA. ADDRESS C105* 
03 FH.UNIT 

04 FH.PORT 
04 FH.CHAN 

04 Ff4.SER.NG.FLAG 

04 FH.EU 

03 FH.AODR 



mLllzUZZ Ul£& 



BITC 

HAVE 
BITC 
81 TC 

8ITC 



BITC 
8IT< 
8ITC 
BITC 
SITC 
BITC 
BITC 
BITC 



BITC 
€ITC 
DSK* 



14)*% LENGTH OF MYSELF IN BITS. 

BITC4)* 

IT OPENED WITH LOCK 
20)*% LENGTH IN BITS. 
4)*% DON'T USE TILL 1977 
20)*% 

WOHB* 

WORD* 

SIT C12)* 

SIT C12)* 

WORD* 
4)*%Q0N*T USE TILL 1977 
20)*% 

24)*% OON*T USE TILL 1977. I6NCRE0 5. 
3)»% HITHERTO =0. FOR RELEASE* =1. 
i)*% HITHERTO 4 8ITS. 
24 3* 

16)*% HITHERTO 0. HENIG£*S GENEROSITY 
8)* 

WORD* 

BIT C12)* 

8IT C16>* 
16)*% 

24)*% OON»T REUSE 
ADR* % DONT REUSE 

aiTCD* 

BOOLEAN* 



TILL 1977. 
TILL 1977 



5.1 IGNGRI 



L* 

8ITTEI 

POINT 



( BOOLEAN* 

BOOLEAN* 
8ITC363* 

SIT 

BIT 

BIT 
OSK.ADR* 
BIT C12)* X 
BIT C3)* % 
BIT C4)* X 
.BOOLEAN* % 
BIT C4)* % 
BIT C24)* 



C2)*% 
C 2 ) * % 
C16>*2 



% Y£AR»JDAY#TIW£ 

HOST RJE 
HOST RJE 

HOST RJE 



The 81G00 MCP includes the capability to allow a file to extend 
over siore than one removable pack or cartridge. Such a file is 
known as a w Multi~Pacfr File** CftPF). Quite obviously* there are 
sorae limitations on the use of such fifes. The individual packs 
or cartridges which contain portions of the file say not o^ 
removed indiscriminately* Various operational details are 

contained in the *81700 Software Operational Guide**. 
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A multi-pack file may have only one "Base Pack* IBP). The nawa 
of the base pacfc is the pack id as specified by the user in the 
FPB of the nut ti -pacfc fits. The base pacfc must be on line for 
all OPENs of the file. The MCP may also require that the base 
pack be on-line for other operations* such as the assignment of 3 
new area of disk to the file. An appropriate message will be 
typed on the console printer by the MCP if the base pacfc is 
required and it is not on-line. The operator may then no ton t tha 
base pacfc and the requesting program will continue* The base 
pack must be on line when the file is closed if it was opened for 
output or input/output. 

A base pack may contain single files* as well as multi-pack 
files* in any combination* It nay not* be a "continuation pack" 
for a multi-pack file whose base pack is a different physical 
pack or cartridge* 

The file header for a multi-pack file is contained on the base 
pack. It contains all information concerning the file* including 
the addresses of every area assigned on the base pack to that 
file* For each area which resides on a continuation pack* the 

header will contain the serial number of the continuation pack. 
This allows the MCP to control all processing of the file and 
thereby avoids the necessity of updating each continuation pack 
as the file is processed* 



tfjaigililXfli. £Mi5i 



A multi-pack file may* by definition* reside on two or more packs 

or cartridges* Wl 

additional packs* 
multi-pack file may 
There may be up 
multi-pack file* 



ion the file overflows or "continues* to 

the term "continuation pack** is used* A 

reside on up to sixteen packs or cartridges. 

to fifteen continuation packs assigned to one 



A continuation pack may be associated with only one base pack. A 
continuation pack may contain only continuation files? it may 
not be a base pack for another file* A continuation pack may 
contain information associated with more than one multi-pack 
file* but all of the files must be assigned to the same base 
pack* 
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The file header* which is contained on the base pack for a 
multi-pack file* contains disk addresses for only those areas of 
disk which are assigned to the base pacK The same statement can 
be made of conti nutation packs? the file header contained on a 
continuation pack contains disk addresses that are assigned on 
that pack only. The file heada/r on the base pack contains the 
serial number of the appropriate continuation pack in the disk 
address fields of the headers* 



When a file overflows from the base pack* the HCP will search for 
another continuation pack that is already on-line and that is 
associated with the same base pack. If such a continuation pack 
is found* the file automatically overflows to that continuation 
pack- If no such continuation pack is present on the system* the 
HCP will then search for a scratch pack* one which has no files 
on it* with the sane type as the base pack. "Type" here sears 
"restricted* or unrestricted** and is determined when the pack is 
ini t ial i zed. 



If such a scratch pack is found* the file automa ticalty continues 
to that pack. If no such pack is found* the HCP temporarily 

halts the program and prints an appropriate message on the 
console printer. The program nay -be continued when a suitable 

continuation pack is present on the system. 

When a multi-pack file is opened input* the file's header is read 
into marmory fr om the base pack, ^hen a multi-pack file is opened 
output* and new* a header is constructed in memory fro* 
information in the program's FPB and' information from the base 
pack. During QPEH the HCP wilt find space on the system pack for 
a multi-pack file information table. The table will contain 
specific information about the base pack* along with an exact 
copy of the disk file header from the base pack. This copy of 
the header is treated as a working copy while the file is open. 
The header on the base pack may therefore not at ways be correct. 

The format of the HPF.IMF0.TA8LE is presented below. One 
MPF. INFO. TABLE p^r file is required* regardless of the nuaber of 
user s* 
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DESCRIPTION 



01 WPF.INFG.TA8LE 

02 HPF .FORWARD 
02 HPF. BACKWARD 
02 MPF.SELF 

02 MPF. NAME 

02 MPF. HEADER. SIZE 

02 MPF.HEA0£R*ADDRE5S 

02 MPF.BPS.NO 
02 MPF. OPEN. TYPE 

02 MPF. NEW. FILE 

02 MPF. NEtf. AREA 

02 MPF.CS 



02 FILLER 

02 MPF. BASE. PACK. TYPE 

02 MPF. ARRAY 

03 MPF. ONLINE 

04 MPF.SERIAL.NO 
04 MPF.HDR.DSK 



,1392 81 TS 
36 8ITS 
36 31 TS 

38 BITS 
30 CHAR 
24 31 TS 

2 4 BITS 

24 8ITS 
4 BITS 

1 BIT 

1 BIT 
BIT 



1 BIT 

4 BITS 



T ABLE. 
MPF TA8LE 
TABLE. 



POINTER TO NEXT nPF 

POINTER TO PREVIOUS 

POINTER TO THIS MPF 

FILE-IDENTIFIER. 

SIZE OF COHPOSITE HEADER 

MAINTAINED BY THE MCP. 

POINTER TO THE COMPOSITE HEADER 

IN MEMORY. 

8ASE PACK C8P) SERIAL NUMBER. 

TYPE OF FILE OPENED. SAME AS 

OFH. OPEN. TYPE IN DISK FILE HEADER. 

MCP FLAG USED IF THIS IS A NEW 

FILE. 

MCP FLAG 

ADOEO. 

MCP FLAG TO M 

HAS PERFORMED 

WAS CREATED. 



USED IF NEW AREA WAS 



RK IF CLEAR/5TART 
SINCE THIS ENTRY 



24 BITS 
36 8ITS 



TYPE OF PACK USED AS BP. 
I=RESTRXCTEO* 2=UNR£STRICTE0 
USED TO RECORD ALL PACKS THAT 
ARE ON-LINE. 

MAXIMUM OF 16 ITEMS IN ARRAY. 
SERIAL NUMBER OF THE PACK. 
DISK ADDRESS OF THE FILE HEADER 
ON THE PACK. 
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In addition to any restrictions listed In the foregoing* tha 
items below are also applicable to jsulti-pack files. 

1. Since a system cartridge may not be a base pack* Autti-oac* 
files are only operational on systems with two or store 
dr i ves. 



Alt packs containing any part of a lulti-pack file lust have 
unique serial numbers* . 
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AH Burroughs printers and controls have hardware capability of 
spacing the paper after writing a line of output but no 
capability of spacing the paper before writing the line. aith 
the advent of the ANSI »74 C08QL Language in the 9.0 version cf 
the software* the need for a sore efficient means of performing 
the COBOL WRITE AFTER ADVANCING statement became apparent* In 

prior versions* this operation was implemented by the coirpilers* 
generated two actual I/O communicate operators for each such 
statement encountered* The first of the two was a Position 

communicate or a WRITE of a line of blanks* the second was a 
WRITE of the actual record with no paper motion specified. This* 
of course* resulted in two communicates as well as two physical 
IQs for every logical WRITE AFTER ADVANCING operation* The 
change described below was first implemented in the 9*0 Operating 
System and is included in all subsequent versions* 

The goal of this modification was to reduce the nuiber of 
communicate operations to one per logical WRITE and to reduce the 
physical I/O operations to one per communicate operation using 
the existing printer hardware* This was accomplished by delaying 
the initiation of the physical I/O operation until the f billowing 
logical WRITE is received* By knowing both the previous and 
current logical I/O requests* a physical I/O can be initiated 
which corresponds to the first request and takes advantage of tha 
Burroughs hardware* 



The diagram in Figure 1 shows the relationship between the last 
logical request issued by the user* the current logical request 
and the actual physical I/O operation that will be performed* 
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Figure 1 - Logi cal /Physical I/O Relationship 



In the proceeding diagram* the operations within the table 
correspond to the actual physical I/O operations that will be 
performed* which will depend upon the current logical request 
supplied by the user and any operations that are still pending 
from the previous request* Wri te/8 and Wri te/A may be read 
"Write Before* and "Write After*. The symbol l:=l say be read 
"is replaced by w . It can be seen in the diagram that so?*3 
logical requests will* at tifaes* result in two physical 
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operations being initiated* Under these conditions* it way be 
beneficial to supply each printer file with at least two btffers* 
if the execution time of the program is the only concern. Total 
system throughput will not be impacted significantly regardless 
of the number of printer buffers and the types of operations 
being performed*. If the MCP must wait for the completion of ary 
printer physical I/O operation* the time that is spent waiting 
will be masked by the processing of other programs. 

Along these same lines* it should be remembered that any time a 
Write operation is left pending and control is returned to the 
user* the MCP must have an available buffer to store the data 
that is to be written. If no buffer is available* control may 
not be returned to the requesting user until a buffer becomes 
available. Again* this tine will be overlapped with the 
processing of other programs and system throughput should rot be 
significantly impacted. 

The action presented in the oreceeding chart for a Space 
operation requires some explanation. A Space of more than two 
lines must be handled by the S«MCP« The Micro MCP witl attempt 
to space the requested number of lines without calling the S.MCP* 
but this is not always possible. In the diagram* when the 
Pending operation is equal to Null* the Micro 'HCP will space the 
paper one or two lines* indicated by *x w in the diagram* and if 
N-x is greater than zero* it will pass the remainder to the 
S.MCP. Similarly* when the Pending operation is equal to a Write 
with No Space* the fticro MCP will issue a Write/8 Space 1 or I 
lines* also indicated by w x* in the diagram* and if the remainder 
is greater than zero* pass it to the S.MCP. When the Pending 
operation is a Write/8 Space 1* the Micro f*CP witl issue a 
Write/8 Space 2 and pass N-l to the S.HCP* if N-i > 0. 

L1MSL £Lau.5& 

The LINAGE clause* in ANSI *7k COBOL is a mechanism which allows 
the user to define a ^Logical Page* format and request that the 
Operating System maintain printer pages which conform to tha 
defined format* as well as a current line position on that 
logical page* In the language* the user may specify the Logical 
Page size* an integer which represents the number of lines that 
may be printed on any page. This attribute will be known as 
PAGE. SIZE in the remainder of this discusion. 

The user may also specify an Upper Margin* an area at the top of 
each page where nothing will be printed* Lower Margin* a similar 
area at the bottom of each page* and a Footing area* a specified 
number of lines in the page foody immediately above the Lower 
Margin area. The user may also ask to (enow the number of the 
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tine in the page body where the last line of output was printed* 
This requires that the Operating Systes maintain a line counter* 
which will be the number of lines written on the current page* 

The a iplementa lion is called the "Logical Page* function in the 
Operating System and it includes the fat lowing: 

1* Positioning to the beginning of the page body i*e» past the 
top margin at OPEN or at page overflow* 

2. Reporting £nd-of-Pege when the user writes or spaces within 
the footing area and requests EOP reporting* 

3* Detecting page overflow* Page overflow is defined as 

occurring whenever the execution of a WRITE would leave the 
tine counter positioned past the page body* 

4. Updating th& logical page description when switching froi 
one logical page size to another* 



Essentially* the implementation obeys the rules presented in the 
ANSI f 74 COBOL specifications* The operating systen wilt 

maintain a line counter* a current logical page description and a 
new logical page decription- The line counter represents the 
position on the page body following the open or the last logical 
write* The current logical page description is used to detect 

end-of-page and page overflow* The new logical page description 
is used to initialize the current logical page description when 
page overflow is detected and to calculate the number of lines to 
the first line of the next page body* 



If the user has specified end-of-page reporting and the lire 
counter is greater than or equal to the line number at which the 
footing begins* then on completion of the WRITE* EOP is reported 
to the user* If the line counter would be greater than the line 
number at which the bottom margin begins at the end of the 
logical WRITE* an implicit position to the first line of the ne*t 
page body is generated according to the before/after variant of 
the write statement* At this point the line counter will be set 
to I* The nunber of lines to skip is calculated according to the 
following formula* 

I ines.to* skip •= current*page .body-size - line.counter + 
current. bo tto«**argi n* si ze * new.top.nar gin. size; 
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The Logical Page description is updated if necessary when a write 
occurs that causes page overflow or whenever an advance to top cf 
page occurs* 



To access the Cine counter requires a File Attribute Coirsunicate 
from ths user program* This will be of no concern to A8SI *7k 
COBOL users* they need only be concerned with the proper syntax 
in that language for referencing the line counter* The Logical 
Page definition is changed to the values included in the write 
Connunl cate format whenever page overflow is detected. To 
accomodate the above requirements* the format had to be expanded 
as shown in Figure Z in the WHITE AFTER ADVANCING section of this 
document presented previously* 

The Logical Page implementation* since it is implemented entirely 
in software* is useable even when the file is directed to a 
Sacfcup medium* The Logical Page i «pl ementat ion is also useable 
by programs that are written in languages other than ANSI *74 
COBOL. This is effected by the implementation of additional 
syntax in the FILE Control Card. Progerias may be permanently 
modified to incorporate the required new attributes* The Logical 
Page function is activated by the PAGE. SIZE attribute in the file 
Parameter Block. When a printer fiie is opened and PAGE. SIZE 
contains a value other than zero* page format wilt be controlled 
by the Logical Page software i mpl ementat i on and the physical 
carriage control tape on the device will be completely ignored 
after the file is open. 



It is important to note that the Channel One punch* as well as 
the Channel Twelve punch in the carri age control tape is ignored 
after the fiie is open. According to ANSI *74 COBOL 
specifications* this is as it should be but it dictates that the 
attributes which govern logical page format must be specified 
such that the logical page size plus the upper margin plus the 
lower margin dust total the exact number of lines on the physical 
page. If this is not done* then eventually at least* lines will 
be printed on the crease between the physical pages* 
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e referenced in the FILE Control 



At tr ibute 



Abbreviation Function 



PAGE. SIZE 



P. 5 



LOWER. HARGiN 



UPPER. MARGIN 



L.N 



U.M 



FOOTING 



FOOT 



The number of lines between the 
Dpper Nargin and the Lower Margin. 
Hay be set to any value between 1 
and 255 inclusive. 

The number of lines frois the page 
body to the bat ton of the fern. 
Hay be set to any value between 
and 255 inclusive. 

The number of lines froas the faottoi 
(or top) of the 1orm to the page body 
Hay be set to any value between 

and 255 inclusive. 

The number of lines froii the 
beginning of the page body* 
within Page. size* to the point 
where the HCP will begin to 
report end~of -page to the user. 
Hay be set to any value between 

1 and 255 inclusive. 



££IMEE MU £M££ fii£*12£ £A£AfiILIIIES 



The MCP includes the capability of directing the output data for 
printer and punch files to i nt erased! ate storage. The storage 

medium way* at the user*s option* be magnetic tape or disk. 
Backup files may not be directed to cassette cr flexidisfc media. 
A utility routine* named SYSTEM/BACKUP* is provided to allow 
users to retrieve the output data fro» the intermediate storage 
aediunu For details on this routine* refer to Product 

Specification 2222 2681* Systeai Sacfcup. 



When the output is directed to magnetic tape* *ulti-fite tapes 
are created unless the operator intervenes in soie wanner. If 
the operator does not intervene* the tape will be closed with no 
rewind when the printer or punch file is closed in the progra*. 
The next printer or punch file which is opened by any executing 
program and directed to backup tape storage will then be added to 
the existing tape. This process will continue until the operator 
intervenes or until the physical end of the tape reel is reached. 
Operator intervention procedures are described in the Software 
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and in the MCP Control Syntax Product 



When the output data is directed to intermediate storage on disk* 
it is entered in the Disk Directory when the printer or punch 
file in the program is closed* At that tiise* it may be accessed 
by any program* though the data contained therein may be 
undecipherable unless the accessing program is written expressly 
for this purpose- The file nay not* under any circumstances* be 
accessed prior to the tine the file is closed* 



M£ISJ2£ fli£ £LD£fiiJ(£ EA£Ifl&£ 



The OPEN routine in the MCP attempts to optimize the size of the 
physical blacks associated with a Backup file* according to the 
declared size of the logical records in the file- The block will 
typically be set to a size equivalent to three or four disk 
sectors* each of 180 bytes* by the HCP. in order to predict the 
block size that the HCP will select for any given logical record 
si2e* it is necessary to consider the control information that 
the MCP stores in the first physical block of the file as well as 
the declared record size* The algorithm that is used by the MCP 
to select a bloc* size is not easily described. The block size 
which is selected is stored in the file label* for tape files* 
and in the Disk File Header for disk files. The logical record 
size is also stored in these fields. 



Consequently* using the Default File Attribute* which is 
described in the Software Operational Guide and in another part 
of this specification* the user cuay access Backup files without 
knowing the blocking factor and logical record size in advance. 
Since the algorithm that is used by the HCP to calculate block 
size taay change froa version to version* this leans of 
deter lining the blocking factor used is preferred. The algorithm 
that is included in the 8.0 version of the I4CP is described in 
the paragraphs that follow. 

The logical record size declared in a file in a user's program 
Jiay be any size. If the file is directed to Sackup storage* it 
is set to a maximum of 132 bytes. The logical record size is 
then incremented by two bytes. This additional sixteen bits of 
information is necessary to contain the formatting information 
which is passed with each Write and Position communicate 
operator. ... 



If the file is being directed to magnetic tape* the record size 
is then incremented* if necessary* to force i t to a nuiber which 
is modulo forty-eight. This is necessary since seven-track tape 
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units require block sizes which are aodulo six and phase~eneoded 
drives require block sizes which are modulo sixteen. It would 

not be sufficient to insure that only block sizes teet this 
requirement* however* since the blocks on any tape file nay be 

partial blocks which contain one or more records. 

The buffer size will always be made large enough to contain 100 
bits of control information plus 1666 bits to contain the 
original File Parameter 81ock as it appeared In the user's 
program* plus* if the file is a printer file* 107 2 bits to 
contain a file label plus its associated spacing information. If 
the original file is a punch file* a space of 648 bits is 
reserved for the label instead of 1072* The one fact which 
complicates this calculation is that all three of the itefs 
listed above must begin on a logical record boundary within the 
physical block* Consequently* for a file with a declared record 
size of 132 bytes* which is converted to 134 bytes or I0F2 bits 
by the OPEN routine* the FP8 will begin on the 1073rd bit in the 
first physical block of thQ file* The file label* if there is 
one* will begin on the 3217th bit '13 x 1072), The first output 
data record will then begin on the 4289th bit. The bloc* will be 
fflade large enough to insure that the first bloc* contains at 
least one logical record in addition to all of the information 
li st ed above • 

For backup files which are directed to intermediate storage on 
disk* the block size computed above is then incremented* if 
necessary* to stake the size module 1440* The number of records 
per block is then computed from record size and block size* 
End-of-File is neyer reported to a user progras when a Backup 
file is being created. The HCP automatically closes the file 
when it is full and also automat ically opens a new Backup file. 
The identifier assigned to the second file will revert to the 
standard naming convention for Backup files* The NFID will be 
set to SACKUP.PRT and the 10 field will be set to the next 
sequential number aaintained by the system* All other Backup 

file attributes* such as the number of copies requested* will be 
retained in the second and subsequent files. * Only the nais 
requested by the user will be lost* 

The HCP also allows users to specify the f H e attr ibut es Blocks 
per Area <BLQCKS*AREA or 8. A)* Records per Slock {RECORDS. 8J.0CK 
or R.8>* and Number of Areas CASEAS or ARE) for printer files and 
these specified values will override the system's default values 
for the same attributes. Using the proper setting of these 

values and the automatic closing an4 reopening described in tfea 
preceeding paragraph* users may begin printing a Backup file 
while the program which created it is still executing and 
creating the second or subsequent portion of the saaie file. 
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Records in Printer files may not be blocked. Consequently* the 
Records par Block attribute is not applicable when the file is 
directed to the printer. Records per Block is uti tiled only when 
the file is directed to a Backup medium* Also* the value 
specified for Records per Block must be greater than a minimum 
value* which is a function of the record size associated with the 
file and which is computed by the HCP when the file is opened. 
It is reccomended that users not set Records per Sloe* for 
Printer files in the use of this facility but establish the file 
size via the Slocks per Area and dumber of Areas attributes only, 
for a file with 132-byte records* Records per Block will be set 
to five by the HCP unless overridden by the user. The simplest 
means of determining the value that will be computed for Records 
per Block by the HCP for any other given record size is to direct 
such a file to the backup medium and interrogate Records per 
Block* 



The MCP insures that access to a backup file is in serial mode 
only* If the user had requested more than two buffers on the 
original file* the number is reduced to two on the backup file. 
In a similar manner* the HCP limits the number of disk areas 
requested to 25. The file type in the original FPB is then 
changed to indicate that the file was directed to disk or tape 
intermediate storage. 

The first block in any backup file is filled almost entirely with 
control information. This information is used by SYSTEM/BACKUP 
when the file is printed or punched. The first twenty-four bits 
of the block will contain the logical record size* in bits* as 
computed by the prior portion of the OPEN routine. The next six 
bits of the block wil contain the number of bits that the record 
size was incremented to make it modulo forty-eight* if the backup 
medium was magnetic tape. If the backup medium was disk* these 
six bits will be equal to zero. The next eighteen bits specify 
the control information size* in bits* This field will contain 
the number of bits which am used in the first block of the file 
to contain the control information* exclusive of the File 
Parameter Block and the label* In the 9.9 version of the MCP* 
this number will be equal to 100* although all of the 100 bits 
may not be used* 

The next twenty-four bits of the block will specify the FPB size> 
in bits* This number may vary from release to release. For tha 
9.0 version of the software* the FPB size is 1668 bits* The next 
twenty-four bits will contain the size of the label* if any* 
associated with the printer or punch file. This field kill 
always contain these values* regardless of whether the file is 
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laoeted or not* The next four bits will contain a number which 

specifies the type of label that is contained in the label area. 

In alt cases* at the present time* this number will be either 

zero* indicating a standard label* or one* indicating that the 
file is unlabetled. 

Unless the computed logical record size of the file is exactly 
equal to the size of the control information listed above* 100 
bits for the 8*0 version of the HCP* a filler will be added after 
the control information* This filter wilt be of a si2e 
sufficient to make the next field in the first block* the FPB* 
begin on a logical record boundary. For example* if the original 
logical record size was 132 bytes and the backup medium was disk* 
the filler would consist of 964 bits* 

The next field in the first block of the file will be the 

original File Parameter Stock as it appeared in the user program 

and before any changes were made by the OPEN routine- Only 

pertinent information* delimited by the size specified by 

FPB*SIZE will be included. Following the FP8* another filter 
will probably be required to make the next field in the first 

block* the original file label* begin on a logical record 
boundary. 

Actually* sixteen bits of', spacing information precedes the file 
label; the spacing information thus begins on the logical record 
boundary. For the label* alt of the sixteen bits will be set to 
zero. These sixteen bits will be followed by the label* which is 
constructed exactly as if the file had been directed to its 
intended medium originally* The label is always constructed and 
stored in the Backup file* regardless of whether the original 
file was labelled ow not* SYSTEH/8ACKUP may or may not caise the 
label to be printed or punched* depending upon whether the fita 
was nr was not labelled* The label in the first block will be 
followed by a filler • if necessary* to allow the first logical 
record of output data to begin on a logical record boundary 
within the block. The first block will always contain at least 
one logical output record. 

£A£JSU£ £IU U2fii£*l. 2£££BI2 IMM1 

Each logical record in the file Will consist of sixteen bits of 
formatting information followed by the user's output data* 
unaltered* If the logical record was generated by a Position 
communicate operator* the contents of the data field are 
undefined and are ignored by SY5TEH/8ACKUP* The sixteen bits are 
defined as follows* 
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Beginning with the 9.0 version of the software* the 
of carriage control Information are subdivided ass 



sixteen bits 



01 CARRIAGE_CQN?ROL 

02 FILLER 

02 3£FQff£_AFTER 

02 CHAKNEL_OR SPACING 

02 TYPE 



BIT 
BIT 

air 

BIT 
SIT 



C16)# 
C3)* 



In the description above* the BEFORE.. AFTER field is applicable an 
WRITE operations which are directed to a printer file. A one in 
this bit position indicates the operation was WRITE AFTER 
ADVANCING, The CHANNEL.GR. SPACING field corresponds to the eight 
bits of spacing information passed on a WRITE communicate in the 
CT. ADVERB field in the communicate operator. These bits are 

defined in the Oemand Hanageiuent section of this document* but 
the definition is repeated here for reference. 

CHANNEL.QR, SPACING 

= 0000 - No paper motion 

= 0001 - Skip to Channel One 

= 0002 - Skip to Channel Two 



1011 - Slcip to Channel Eleven 

1100 - Slcip to Channel Twelve 

1101 - Skip to first line of the 

pr inter only) 

1110 - Single space 

1111 - Doubt a space 



fora (1500 LPH 



The TYPE field in the description provides information on tha 
type of communicate issued by the user on this record. The 

CARRIAGE^GR^SPACING value will have different leanings* depending 
upon the value of the TYPE field* The correspondense between the 
two is shown below. 



TYPE 


Operation 


C000 


WRITE 


0001 


WRITE 


0010 


SPACE 


0011 


SPACE 


0100 


WRITE 



CARRIAGE^GR^SPACING Vatue 

Printer Channel number 

Punch Stacker Nunba'r 

Number of Records to Position 

Printer Channel Number on Position 

Printer Spacing Information 
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A Relative file consists of records winch are Identified by 
relative record numbers. The file ?Bay be thought of as composed 
of a serial string of areas* each capable of holding a logical 
record. Each of these areas Is denominated by a relative record 
number* For example* 



the relative record 
whether or n o t r e c or d s 
ninth record area* i 
fi les» 



the tenth record Is the one addressed by 
number 10 and is in the tenth record area* 
have been written in the first through the 

Relative files are implemented using direct 



M£££l £11 AS 



Direct is the primitive file organization. A direct file is 
divided into a number of "record slots** of fixed length* each of 
which iaay contain one record. A record slot is "efflpty* if it 
contains no valid record* Full record slots »ay be made empty by 
deleting the record they contain* making the contents 
unaccessable through the normal mechanism. Since all bit 
patterns arm potentially near-i ngful as data* a separate ^rea in 
each block of the file is maintained to indicate which record 
slots within that block have b^&n used. There will be one such 

"Presence Bit* for each record slot in that block and the bit 

vector thus formed is known as the Block Control Information 

(BCD. The user is not allowed to have access to the Block 
Control Information under normal circumstances. 



SaLaliss f 11* Bala ££fU4£lu£& 



The Relative file is a direct file* The blocks of the Relative 
file contain Slock Control Information:-'' (BCD as well as data 
records. The number of data records in a block is conatined in 
the "Recordjs.._.p.ar._B.tocJc* Xi,eld_oJ^he_ jfj sk .file header: in the case 
of an existing -file* Originally* of course* this nuasber is 
specified by the user . program! er In his Filer Declaration* The 
data records wilt be located on byte boundaries to confers with 
the addressing capabilities of the 91000 Interpreters. The 3C£ 
will therefore be padded with zeroes to insure this. When a 

Relative file is originally created* all of the record slots are 
empty. Consequently* the presence bits in the SCI lust be 
initialized when the area is allocated. 
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The use of presence bits to Indicate that a record has been 
written into an available record slot means that disk areas that 
are allocated to a Relative file .must be initialized when they 
are allocated. All presence bits in the aiock Control 

Information must be set to zero at this tine* 



When a disk area is required* the HCP will be responsible for 
allocating the area* and will also be responsible for 
initializing presence bits* If the access node of the file is 
sequential* the MCP lust allocates the area and the Logical I/O 
routines will initialize each block before accessing it. If the 
access mode is random or dynamic* the HCP will initialize the 
entire area teeing allocated by automatically executing a special 
initialization program which will run at the user's priority. 



The user will have the option of executing this 
prior to executing the program which accesses 
initialize the entire file or any areas he 
sequential mode* if the file is closed with the 
at the end of an area* the HCP will initialize 
that area. 



program himself* 
the file* to 
choses. In the 
EOF pointer not 
the remainder of 



The program which initializes newly allocated disk areas for 
Relative files is called SYSrCH/REL.INXT. If this program is 
called automat icatlv by the HCP as described above* the program 
which requested the new disk area will not be allowed to execute 
until SYSTEM/REL*! NTT has completed the initialization of the new 
ar e a . 



£&LaiI*£ Eila fauiftj&c Ils£&£ ILfljal 



The FP8 for a relative file is the same as for a Conventional 
random file except that F£ 8, ACCESS is set to a value of 2* 
indicating Relative organization* ~" — — 
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The OFH for a relative file is the same as for a Conventional 
file except that the block size field will include the size of 
the block control information. 
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The FI8 for a relative file is the same as for a Conventional 

random file* except that 3 field which identifies the file as 
being Relative has bean added. The field is named the 
FI8.0RGANIZATI0N field and can assume values of zero* indicating 
a Conventional or ANSI *74 Sequential file* one* indicating a 
Relative file* and two* indicating an Indexed Sequential file* 

Buffers for Relative files will be the same as for Conventional 
files. They uili.be allocated when the file is opened with one 
I/O descriptor for each buffer and the buffer size equal to the 
block size* which is equal to the record size times the nusbar of 
records per block plus the size of the block control information 
<1 bit/record made modulo eight). 

Suffer management for Relative files wilt depend on the usar's 
access aethod - Sequential* Random or Dynamic. For Random access 
the management of the buffers will be the sane as that for 
Conventional random files. READ operations will be initiated on 
demand and WRITE operations will be initiated immediately after 
the logical I/O operation has occurred. If the access mode is 
Sequential* the buffer management will be the same as that for 
Conventional serial files. The Open procedure will fill all of 
the buffers and the Operating System will try to stay ahead of 
the user program* initiating physical Read operations when the 
last logical record in a buffer has been delivered to a user and 
initiating physical Write operations when the last logical record 
of the buffer is received. 



The Dynamic access mode in ANSI *Jh COBOL allows the user to 
switch between the Random and Sequential modes. In the Dynamic 
access mode* when switching from Sequential to Random* the last 
block is written to disk if it has been updated. When switching 
from Random to Sequential* the SHCP is called on to fill the 
buffers as if an OPEN or Position had occurred. In the Dynamic 
access mode* the access mode desired* Random or Sequential* must 
be specified in the communicate operator generated by each 
logical READ operation. 



fiaijiiss £ii£ ZsMmnizats Usscalacs 



Three new communicate operations* corresponding to the verbs 
DELETE* START and REWRITE have been added to the 9.0 Operating 
System. To simplify the implementation and to avoid potential 
file equivalence problems* new communicate operations for 
relative files have been added to the software* rather than 
modifying an existing operation. The READ* WRITE and REWRITE 
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connumcate operators have a format which is similar to the 
format for the READ* WRITE and REWRITE communicate formats far 
conventional files. The format for the DELETE operation* on 
Relative files* is similar to the format for the saae operation 
on Indexed Sequential files. The ANSI *7k COBOL START verb has 
been implemented as a new communicate and is handled by the Micro 



1-53 



BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLA^T 



COMPANY CONFIDENTIAL 

81000 MCP II 

P.S. 2212 5462 IE) 



iQitSJ^il lfi£JJ£n£iJl Hl&M 



Indexed Sequential files consist of two new primitive file types: 
Direct files and Index files. For each Indexed Sequential file 
there is one and only one data file and this file is ifptemented 
as a Direct file* For each key of the Indexed Sequential file 
there is a corresponding file of type "index". In the MCP code* 
these two types are listed as f NDEX.SEQ.DATA. SET .FILE and 
INDEX. SEQ.INDEX.FILE? they will be refferred to as Direct files 
and Index files in this document* 



j)i£Ml EiijgJ 



Direct files 
files. A 

convenience. 
di scussi on. 
divided into 
which may 



were discussed in the documentation on Relative 

portion of that discussion is repeated here for 

More details will toe found in the proceeding 

A Direct file is a primitive file type that is 

a number of "record slots* of fixed length* each of 

contain one record. A record slot is "empty" if it 



contains no valid record. Full record slots may be made empty by 
deleting the records they contain* making the contents of that 
slot inaccessable by the normal mechanism. Since all bit 

patterns are potentially meaningful as a record* a bit flag is 
maintained for each record slot to show the validity of its 
contents. 



Since alt record slots are the sane size (MAXR£CSIZE> the 
absolute di sic address can be easily calculated from the record 
slot number. The file is divided into groups of record slots 

called "blocks*** each consi sting of "blocking factor* record 
slots plus the "Block Control In format i on*** a bit iasl which 
indicates the presence of a valid record plus enough filler bits 
to make the container modulo eight. Thjere„JS-a-^sJL_gjnijtic^iit 

d i f f er e n c e _b e i Mj&.e.n the- Bloc *L_^on.tro_l rnforaa t io n for ._ __a Direct 

file an4 an Index file* however. 
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An Index file is the second new file type, 
fixed length records organized in tables 

Information to describe the table. £acjh._ 

will co ns-ti t u e__a_ se para te t able. The importance 
will be explained later. 



Index files contain 

with Slock Control 

ock of an Ijn d_e x fj J e 

of "this fact 
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The records in the . .Index fiie consist of Key /A flLolimi. pairs * The 
addresses point to other tables in the Index file or tcT Yecords 
of the Index Sequential file's data file* the Oirect file. The 
tables In the Index file form a tree structure and the records in 

the table at.e~-or4er.aji_Jy£_ feey vaiue to allo w fast randoi acceTs. 

The tables whose entries point to data ~~ "Fecords ~" "aYe linked 
together to allow fast sequential access* 

£lllS.t££ Ql££ 

In addition to these two new file types, there roust reside* 
somewhere on disfc* infocaation relating all of the various files 
which compose an Indexed Sequential file. This inforiation is 
maintained* by the HCP* in a third new structure which will be a 
separate conventional fiie on disk and which will be known as a 
"Cluster" file* The name of the Cluster file will correspond to 
the user's declared natie for his Indexed Sequential file. In the 
HCP code* this file type is referred to as an 

IND£X*S£S.uLQBAL.FIL£* though it will be called merely a Cluster 
file In this document* 

The Cluster file provides the ability to reference the entire 
Indexed Sequential file structure by sifflply referencing the 
Cluster file* When the Compilers generate code which applies to 
Indexed Sequential files* they actually reference the Cluster 
file. The Cluster file will contain the names of the other files 
associated with the Indexed Sequential file- As sectioned 

previously* there will be one Index file for each key listed in 
the Indexed Sequential file* 

The statement above does not mean that all of the Index files 
will be opened when a Cluster file is opened* The Index files 
are only opened when they ar% first referenced in the prograa and 
this actually happens automatically.* The co&pilers do not 

generate code to open the Index files. The MCP simply detects 
that the referenced Index file has not yet been opened* obtains 
the necessary information fro» the Cluster file* and opens the 
file . 



The -Clu5_te r file does requir g _aji__a dda t ional Disk Fi le Header in 

me aor Xf i...,.H]L ut -JanLy Mh±£&— ~j hi Indexed ___S equent ial file is bein g 
opened* It is not necessary for it to be in aeflory after TFe 
frte"~fias been opened* The Cluster file also adds an entry to the 
user*s disk directory* The diagram below shows a Cluster file 
schematically* This particular file has one primary* or *Pri«e* 
Key and one Alternate Key* 
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! Ctwster I 

1 File I 

111 

i i I 

\l/ \i/ \i/ 

4.---- -----*• i.-----------* + * ------- 

i Primary 1 I Alternate i I Data 

i Index I I Index I * File 

I File I 1 Fife 1 J 



This organization for Indexed Sequential files offers several 
advantages over any other. Each file* the file which contains 
the actual data and ail of the Index files* will ha\/B fixed 
record and bloc* sizes. This wilt simplify the problem of 

managing the buffers that are assigned to the files. Soth of 

these file types are nothing more than Conventional files with 
some order imposed upon the contents of the file. Consequent! y* 
the Oisfc File Headers* or . "Fila Descriptors" required for each 
file are the sane as those for Conventional files. This is 

discussed in more detail later in the document. 

Conceptually* this mechanism is easier to visualize and implement 
than would be multiple structures residing in one physical file. 
Also* any of the files may be located on different spindles* 
which will clearly improve performance* since arm movement time 
fljay be overlapped* and access to all oi the files fay occur 
asynchronously. The Oirect file and the Index file may be 
accessed independently of each other. 



The design does impose certain restrictions* which fall in the 
category of "operational* restrictions and which do not impact 
performance. A checking mechanism is required to insure the 

integrity of files which are accessed independently. The MCP 

must insure that the correct version of the Index file is used 
with its corresponding Oirect file. Also* some extra memory for 
Disk File Headers will be required* since sore actual Headers 
will be required. A naming convention for all of the files must 
be imposed* thus removing some small amount of generality fros 
the user*s capabilities. This may actually be an advantage* 
however. The naming convention is implemented in the Compiler* 

not in the HCP* though this say not be apparent to* and should 
not be important to the user. 
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The Cluster file is a Conventional data file which contains the 
information relating alt the component files of the Indexed 
Sequential file. The structure of the Cluster file Is simitar to 
the Data Base Dictionary format in the Data Hanageaent Systes. 



* -—- — — — — — — .— -- — —. — * 

t I—--- + 

f Index Sequential i I 

I File Global s I--—* l 

I 111 

I t OFff. EXTENSION* Structure 1 i It 

4 * — ,- — . - — — .. # j , 

I I OFH. EXTENSION Structure 2 1 I I 

i / / 1 i 

I / / I I 

I *-••- — -—-<- — — ------ — -«. — .- + | | 

I I QFH»£XTENSI3N» Structure n 1 J 1 

I 4---.----. ---.----..-----. ----- +< --- # | 

I I File Table - Contains all of I I 

+— — 1 t fo 9 nawss f the subfiles f I 

,§. ------------------ ------------ f(< -,------ 4 , 

I Structure Oesc* Structure 1 1 

I Structure Oesc. Structure Z 1 

+ <— ——-.— — — ------ --------- + 

/ ' ' / 

/ 1 

i Structure Oesc. Structure n i 

£.-----,-- — — ---.- — .— «-- — _ — -.. j. 



The OTH*EXT£NSIQN and Structure Descriptor fields shown above are 
both discussed In the paragraphs that follow* The pointer shown 
above from the File Table is one of »any. There is an entry for 
each file in the File Table and each entry has a pointer to its 
associated 0FH*£XTENSI0N. 



The data file, of an Indexed Sequential file is a Direct file. 
The blocks of the data file contain Block Control Information 
IBCI) and data records* siiilar to the blocks of a Relative file 
as presented previously* The number of data records in a block 
is specified by the Records per Bloc* field of the disk file 
header. A similar structure is used on Indexed Sequential files 
in the Data Management System* dtocfc Control Information for the 
Index files associated with all Indexed Sequential files is 
significantly different from that for Relative files. 



3-62 



BURROUGHS CORPORATION 
CQHPUTER SYSTEMS G80UP 

SANTA 9AR8ABA PLftftT 



COMPANY CONFIDENTIAL 

BiOOO MCP II 

P.S. 2212 5462 CE3 



Index files contain records consisting of Key/Address pairs 
within a block. The file itself is a tree structure whose nodes 
are blocks. Each block of the file is a node or table. The 

first node is the root table. The root table and tables on alt 
levels except the last ar® c ait ad coarse tables. The tables in 
the tast level of the tree are catted fine tables* Entries in 
coarse tables point to the next level table whose highest entry 
snatches the key of the coarse table entry. Fine table entries 
point to a record in the Oirect file whose key matches the fine 
table entry CSee Figure 3K Fine tables are linked together in 
logical order to provide fast sequential access and easier 
Current Record Pointer CCUftRENT) maintenance. 

The addresses In these tables ^re not absolute disk addresses. 
Instead* they are thirty-two bit combinations of an area number* 
a segment number within the area and a displacement into the 
segment. This displacement is merely the record number within 
the block. All addressing of Index tables as well as of records 
in the data file is accospi i shed on a relative basis as opposed 
to an absolute one* 

The blocks in Index files contain Block Control Information of a 
different content and format. The format and content of the 
Block Control Information maintained in an Index file is shown 
below. A similar structure exists for OHS Index files. 



Oi INDEX. FILE SCI 

02 BC.TYPE 

02 SC. PRESENT. RECORD. COUNT 

02 8C. NEXT. LOGICAL. BLOCK 



BIT (38)# 

SIT tZ)*l 0=C0AR5E* 1=FINE 

BIT €123* 

8IT C24)IX VALIO FOR FINE TABLES 



The individual records in the Index files have a fixed format; 
since the Key specified by the user must be contained in these 
records* the size of the records may vary with the keys but the 
format will always be as shown below. The same format 
the Data Management System for records in Index tables 



is t s e d by 
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01 INO£X„RECQRD DECLARATION** FOR OHS AND ANSI »74 INDEX FILES 



02 IR.PQIMTER* 

03 IR.AR£A,D!SP# 
04 IR.AREA.NM8R 
04 IR.SEG*NH8R 
03 IR, OFFSET 
02 IR.KEY 



BXTCS)* 
8ITC16)* 
8ITC8}* % VALID 
BITCKEY.SZZE); 



FOR FIKE TA8LES 



The organization of an Index file Is shown in the diagram below* 



I 
\i/ 

4 a. a. a.*... a. a. *.*■$. 

I coarse I 
I table I 

! 



*-■«-----—-♦. 
I root I 

I table f 

£.*.«.«.*.*.*.-*.«. 3. 

I I 1 

1 ! f 

I ..„. 

I 

\i/ 

•^ aa aa aa a» aa aa *■ *■ a» £, 

1 coarse % 
! table 1 

i I 

i ' t 



1 
I 



! 
VI / 

I coarse i 
1 table I 

1 
J 



1 III 

VIZ M/ \l/ \1/ 

I fine I I fine I I fine i ! fine I 

1 table |<--— — | table K — -I table I <«—'-! table I 
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I e 
1 x 
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J f 
i i 
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I 
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I 
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I 



|>**aaaa*«*| | a «««a«a aa | #■'"»"» * 

If I | 

\l/ \i/ \J/ \i/ 

1 

J data file 

I 

4> a. a. a. a. a. a. aa a. a. a. a. -—•— — -• a... a. .a. a. a. .-.a..,-.. 



I 1 I 

J J ---.-a. 
| «| .,- 

1 
1 

I 

—.-»-«. a. . »• ••«« a. -.aaa, a. a, «J 



Figure 2 - Index File Organization 



This structure for the Index files allows the implementation of 
the most efficient search and addition algorithms. Linking the 
last level of the fine tables together allows efficient 
sequential access of the records in the data file* Using this 
link* the CURRENT need only point to the last entry accessed in 
the fine tables and not to the path through the coarse tables to 
the fine tables. This eliminates the need for restrictions on 
the number of levels allowed in order to maintain the CURRENT- 
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CURRENT. 



caused by 



The Fits Paraaeter Stock CFP8) of the Cluster file of an Indexed 
Sequential file wilt be positioned in the code file among the 
other FPBs according to the order of it*s declaration In the 
user's source code. In addition to the Information normally 
contained In an FP8 for a Conventional file* a Cluster file FP3 
will contain a type field which Identifies it as a Cluster fila 
FPB*. a pointer to the data file FPB and an integer which 
Indicates the number of keys associated with the Index Sequential 
file* There uili be one FPB for each Key declared and these FPfls 
will I simed lately follow the FP3 for the data file in the code 
fiie of the program* This is shown in the diagram in Figure 3. 



Default values are used for the file attributes of a Cluster 
file. The user aiay not change these values. The number of disk 
areas wilt be set to one# records per block will be set to one* 
block size will be set to 180 bytes and blocks per area mill be 
set to 50- The ALL*AT*GPEN boolean will be set* causing the disk 
area to be allocated when the file is opened for the first tine* 
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1 I 

i PROGRAM PARAMETER I 

4 BLOCK I 

♦ -— 1FP8-PGINTER J 

11 \ 

% ft """" 7/ 

I \\ SCRATCHPAD AREA \\ 
I // CODE // 

4 \\ _. \\ 

FP8 (file 01 1 

, , I 

I FPB tfile II J 

I : ,__ 1/ 

I FP8 €CLUS?£i~FILEJ~t 

* ... . ...J \ 

// 
\\ 

. . __// 

FP8 COATA FILE* 



1 



02 FP8. FILE. TYPE 



SIT <8)#* 



I \\ 
I // 
+ -->! 

1. 

4 

l_ 

I 

4_ 

// 

\\ 

ft 

i 

t 



02 FPB»IS.SU8.FP8,PTR BITC12)** 
% nufflber of FP8s displaced froi 
Z the first FP8 (file <n. 
FPB«IS.NU#.5U8.FP8S BIT C8>*» 



02 
02 



REMAINING FP8»S 



FP8. IS. NU«.I0*0£5C SIT C6>»* 



FP8 (KEY # 1) 



FPB CKEY # 2) 



1 
1 

l\ 
« \ 
i\ \ 
4 \ 



FP8 CKEY # an 



// 
\Y 



<i)#* 



1 KEY*PARAM£TERS# 
02 KEY*FLAGS# 

03 KE¥,PRI!4£ 8IT 

03 K£Y.DUP»ALLOW£D SIT 
02 K£Y,0£SCRIPfIOM* 

03 KEY. OFFSET 3ITC16),* 

03 KEY. SIZE 9ITC12),* 

03 KEY.SIGNED BIT (1),* 

03 K£Y*D£C£NDIN& SIT CD,* 



* New field in 9*0 Software 



Figure 1 - Code File on Disk 



Some changes were also necessary in the Program Parameter Block 
in the 9.0 software* The changes are required to prevent 

programs which contain Relative and Indexed Sequential files fro* 
being executed on versions of the WCPs released prior to the 9,0 
version. Further* program code files which are executed under 
control of the 9,0 HCP rosy no longer be executed under control of 
any prior MCPs. For this reason* users who anticipate returning 
to prior versions of the HCP are advised to retain copies of 
their code files and to not execute these copses under control cf 
the 9m Q software. 
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Generally* the memory structures used in the Indexed Sequential 
implementation are much like the current Data Management System 
memory structures* with but a few exceptions which take advantage 
of the more specific requirements of the ANSI *7k C080L 
definition. Unlike DHS* which does not use File Information 
Blocks in memory* Indexed Sequential files will have an FI8 
dictionary entry which wilt point to an Indexed Sequential Fie. 
Since the files may be shared among the programs that are 
executing* this FIB will contain only the information pertinent 
to a specific user and will be referred to as the User Specific 
Information ttfSI) field. 

The USI will contain a pointer to the file specific information* 
the information that relates only to the file itself regardless 
of who is using it. The central element in this structure is the 
information necessary to relate the various component files of 
the Indexed Sequential file. This is actually global 
information* glooal to alt of the users* and will contain a tabte 
whose entries point to information specifically concerning the 
component file* The structure which contains this information is 
referred to as the Index File Structure Descriptor CSTR). There 
will be one Structure Descriptor for the data file and ore for 
each Index file associated with the Indexed Sequential file. 



Structure Descriptors contain pointers to the OFH* Suffers and 
CURRENT information associated with the various Index files. The 
relationship of the various memory structures used is shown 
di agramaticatl y in Figure 4« 
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I FIB QIC 1 (User #1} 

..j*. ......... £ 
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\1/ 

^ ....... ^. 

1 USI I *'*•• «-«——-<««.•-. ....... .^ 



CUser #2) I FIB OIC f 

♦ ---- — -■ + 

I 
\i/ 

* . ., — ----i usi i r 



——«-——— ——..••i 64oba i S i... M>J I00 1— >| I0C |._ t 

' I I 

1 * ... mm .«, 

\l/ 

I STR I— ->ICUHRENT» User #1 4 -~->l CURRENF* User #2 1--H|> 

l *.- — ->| DfH I 

+ ----* — ->| BUF !<-->! BUF i<-->;| 8UF I--I1I> 



*->i SIR I— - >1CU«*£N!# User #14 >tCURR£NT* User #2t--1ll> 

^--...^ «.-»----..--.... ...3. *-.---. ........... + 

I I 

I i *-- «- + 
j + .. >, 0FH 1 

I 

■ *-- — -♦ 
Figure 4 - I-S'Fite Memory Structures 



£13 Mstia.a3r.is3 



From the user's view point* Indexed Sequential files are wore 
like a Conventional Random file* except for the fact that 
symbolic key values are used* than they are like QMS structures. 
Though the Data Management System is a superset of the Indexed 
Sequential implementation* the user is more likely to have 
several small and transient Indexed Sequential files than 
large file which he would treat as a data base. 



one 
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A secondary* but important* goal of the design of the ANSI * 7k 
COBOL implementation was to allow a ssooth integration of 
Relative and Indexed Sequential files with the Conventional file 
mechanisa. For this reason and for other reasons* access to an 
Indexed Sequential FI8 is via the FIB Dictionary* which is also 
used to access Conventional file FiBs, The FIB for an Indexed 
Sequential file is itself quite different frois the FIB for a 
Conventional file- The Indexed Sequential file is associated 
with several physical files* whereas the Conventional file is 
associated with only one» Also* more than one user aay share the 
information* including the data buffers* of an Indexed Sequential 
FI8* a Conventional file FIB is used by only one user. If two 
users are accessing the same physical Conventional file* each 
user will have his own F I 8# 



For these reasons* an Indexed Sequential FIB contains three major 

parts: 



1. User Specific Information 

2* File Global Intonation 

3. Component File Specific Information 



The entry in the FIB dictionary corresponding to the Indexed 
Sequential file points to the User Specific Information CUSI) of 
this Indexed Sequential! FIB» 



iGiteisii isjsii£QliJl Us&t. l£££iii£ Ialoxt.iiiG.fi 1125IJ 



The U5I contains information associated with one user only. The 

iMCP must know how the user has opened the file* for example as 

INPUT* and how the user is accessing the file* such as 
sequentially. This information is kept in the USI. User 

statistics* status and WCP workspace are also tept ir this 

structure. Finally* there is a pointer to the next part of the 

Indexed Sequential FI8* the global information associated with 
the physical file* 
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02 Fl 
03 



02 



8 5* t 



03 



US 
03 
03 
03 
3 
03 
03 
3 
03 
03 
03 
03 
03 



03 

03 
03 



)* 
># 
>* 
>* 



B.COMHON. PORTION BITC2 

FI8.BG0LEAN5 9ITC5 

€4 F1B.QPEN 3ITCI 

04 FI8. CLOSING 8ITC1 

04 FIB.QUTPUT 8ITC1 

04 FI8.INPUI SITU 

FIB. ORGANIZATION 8IT<4 
XI- RELATIVE 
% 2 = INDEXED/SEQUENTIAL 

I. FIB* 

FI8.U5I.NQT.FIRST.TIHE.THRU SIT CD* 

FI8.USI*LASr«aP.ftEA8 8XTC.1)* 

FIB.USI. DUPLICATE 8ITC1)* 

FIB. US I. NATCH. FOUND 8ITCU* 

FIB.USI. UPDATE. FLAG 8 IT CI), 

FIB.USI. FIR ST *P*$S 8 IT C 13* 

FILLER 6TT<2>* 

Ff B.USI.ACCESS.MOOE RIT€4}# 

F I B.USI. JOB. NUMBER 8IT<?4»* 

F 1 9* U SI. RECORD. ADDRESS 8 IT €24)* 

FIB.USI. KEY. POINTER 8IT124)* 

FIB.USI.COMNUNIC ATE. WORKSPACE*. BITC6I6)* 
04 FIB.USI. BINARY. SEARCH. ARGUEHENTS BITC208J* 

04 FIB.USI. INTERFACE. PAOS SIT196), 

04 FIB.USI. SAVE. STATE. AREA BIT€3i2>* 

FIB.USI. GLOBAL. POINTER SIT<24)# 

FIB.USI. CURRENT. STRUCTURE 9ITC81, 

Ff 8.U5I.HCA0ER 9ITC24>; 



The first 
220 bi ts of 
USI are the 
sase as 
Conventional 
FIBs 



Lutein JjiiusfliiM Oia JlnliJl MintMMtim lliLitfiLSl 

As shown in the above diagram the first 2ZQ bits of the User 
Specific Information are the same as the first 220 bits of an FI3 
for a Conventional file. The rest of the information can be seen 
to be items that &re peculiar to a specific user of thd 
structure. It is information that is necessary for Operating 

System storage of the "stats" variables that may be required to 
perform a single operation for this user. 



Included in this information is a pointer to the next portion of 



an Indexed Sequential FIB* the file Global 

information* known as the GL08ALS field* 

about the various physical files which 

Sequential file. Its sain function is to 

required files necessary to complete an 

secondary function is to store information global to the Indexed 

Sequential file. 



i nf or /nation. Thi s 

contains information 

comprise an Indexed 

provide a path to the 

I/O operation. a 
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The path to a particular component file is provided by a system 
descriptor contained in a table of system descriptors. The first 
entry of the table points to the data file. The retaining 

entries point to index files* one for each key declared* they 
appear in the order of the declaration of their corresponding 
keys. For any operation which specifies a fcey* the compiler will 
specify the icey number* which will be used as an index into this 
table. 

The global information consists of pointers to the chain of I/O 
descriptors to be used for operations on the Indexed Seauential 
data file* a count of users who are updating the file* and Lock 
bits to support ANSI *74 COBOL's fite level lockout. Also 

contained in GL08ALS are the count and flag fields necessary to 
enforce the prohibition on concurrent updates. A programmatic 

description is shown below. 



01 GL08ALS 

02 GLOB. VERSION. NUMBER 

02 GLOB. DUMBER. OF. USERS 

02 GL08. NUMBER. OF. UPDATERS 

02 GLOB. DISK. COPY. ADDRESS 

02 GLOB. SIZE.IN. BITS 

02 GLOB. MEMORY. ADDRESS 

02 GLOE. LOCK. BITS 

02 GLOe.IO.DESC. CHAIN. ADDRESS 

02 GLOB. NAX, STRUCTURE. NUNBER 

02 GLOB. FLAGS 

05 GLOB. OHS. FILE 

03 FILLER 

03 GLOB. WRITE. ERROR 
02 GLOB. CONCURRENT. INFO* 

03 GLOB. INUSE. COUNT 

03 GLOB. CONCURRENT. FLAGS* 

04 GLOB. FILE. AVAIL 8ITCD* 

04 GLOB. UPDATE. REQUIRED. OR. INPROC BITC1), 
02 GLOB. STRUCTURE. DIRECTORY* 

03 GLOB. STRUCTURE. DESCRIPTOR SY.DE5C* 



Alt of the pointers to subsequent portions of the Indexed 
Sequential structure* alt of which are known as Structure 
Descriptors* are contained in the GL08ALS field. This simplifies 
the task of maintaining the structures and it allows the buffers 
to be shared among the various users. It adds one level of 
indirection to all accesses to the data of course* but this 
expense is small for the benefits it yields. 



8ITC8)* 








8ITC6)* 








BITC6)* 








OSK.AOR* 








BIT116)* 








8IH24)* 








BITC2)* 








8ITC24)* 








8ITC8)* 








81T<6)» 








81 TCI), 








BITC43* 








8ITC15* 










% 


AT THIS 


CMS INFO AND 


8IT16)* 


X 


IS INFO 


ARE DIFFERENT 




X 


TIL STR 


DIRECTORY 



^-71 

BURROUGHS CORPORATION COMPANY CONFIDENTIAL 

COMPUTER 5YSTEHS G80UP 81000 MCP M 

SANTA BARBARA PLANT P.S. 2212 5462 (£) 

the Structure Descriptor is similar to an FIB for a Conventional 
file except that ail of the User Specific information is removed 
and maintained in the USI field* For the Index files of an 
Indexed Sequential structure* necessary key information is also 
kept in the Structure Descriptor* For example* the position of 
the key within the data records* it*s size* whether or not 
duplicates are allowed* and whether or not it is the prine key 
are all stored in the STR. A programmatic description is shown 
be low* 



01 STRUCTUR£_0£5CRIPTQI** 

02 STR. NUMBER SITC8)* 

02 3TH.IYPE BITC4)* 

02 SIR, USER. COUNT BITC6)* 

02 STR.BUFFER.LGCK 8ITC2)> 

02 STR. BUFFER.LIST. POINTER 8IT{24)* 

02 STiURECORDS.PER. BLOCK 8ITC12)* 

02 5Tft«SEGM£NrS. PER. BLOCK BIU8J* 

02 STR. RECORD. SIZE 8ITC16)* 

02 STR. SLOCK. SIZE 8ITC16)* 

02 STR. BLOCKS. PER. AREA 8ITC16)* 

02 STR. SEGS. PER. AREA BITC16)* 

02 STff.QFH.ADDRESS BITC24)* 

02 FILLER 8ITC16)* 

02 STR. CURRENT. POINTER 8ITC24)* 
02 STR. FLAGS 

03 STR. PRIME. KEY BITCD* 

03 SIR. OUPLICATES. ALLOWED BITCD* 

03 SIR. SIMPLE. KEY BITCD* 

03 FILLER 8ITC5)# 

02 STR.SPLITFACIQR 8ITC12>* 
02 STR. KEY. INFO* 

03 5TR.NUM8E&.GF.5U8.KEY.S BIUS)* 
03 STR. SUB. KEY* 

04 STR. ITEM. OFFSET 8ITC16}* 

04 STR. ITEH. SIZE 9ITC123* 

04 STR.ITEM. SIGNED BITCD* 

04 STR-ITEM. DESCENDING BITCD? 



As shown in Figure 4* the Structure descriptor contains a pointer 
to the Disk File Header* the MCP-defined structure which is at 
the last level. This structure* as it always has* contains 

information relating almost exclusively to the physical 
characteristics of the file. Any logical information in the 

header* such as record size and records per bCocfr* was obtained 
fro» the program which originally created the file. 

The format of the disft file header had to be expanded in the 9.0 
version of the software to accomodate the ANSI »74 COBOL 



3-72 

BURROUGHS CORPORATION COMPANY CONFIDENTIAL 

COHPUTER SYSTEMS GROUP 31000 HCP II 

SANTA BARBARA PLANT P.S. 2212 5462 (E> 

implementation. Prior to the creation of the 9.0 version* 
several pieces of Information associated with OHS Data Bases* 
which should have been part of the DFH» were maintained 
separately due to a lack of available space in the then curent 
definition of the disk file header* These fields have also been 
incorporated in the new disk file header* The new forwat has 
been designed to prevent the occurrence of such problems in the 
future* whenever the need for new fields In the OFH arises* 



Stilt £il£ Ma&sz. OlsBMaai 

Some efficient means of available disk space maintenance had to 
be devised for Indexed Sequential files. To accomplish this* the 
necessary information regarding the available space is taintained 
in the Cluster file as a data record, tfh en an Indexed Sequential 
f ULb X s opened* t h i s i n f or m at i on is brought into me* c r y an di 
stored ~Tn aZI^¥wM3l3¥.IJ^.Mhi c^ZM^JIZJmm^jat ^7 foTiow tTe Ofsr 
File Header for the data file- This area is known as the Disk 
File Header Extension. 

Xii4£&£d Issasuiial jLUJl tils jtadsx Olsosiso 

When the Indexed Sequential file is opened* the intonation on 
the available space within the Oirect file* all of which space is 
not available as far as the system is concerned* is brought into 
memory and stored in the OFH Extension. The forsat of this 

information in memory is as shown below. 



01 DFH.1S. EXTENSION* 

02 FILLER 8IHl.fr)* 

02 DFH. IS. EXTENSION. SIZE BITC16)* 

02 DFH«I$«£XTENSX0N«VE3Siatt BITC56)* 

02 OFH. IS. NEXT. FREE. REC080 9ITC32)* 

02 OFH. IS. NEXT. FBEE.8LQCK 8IH32>> 

02 0FH.IS.RGGT.TA8LE 8ITC24)* 

02 0FH.I5.UP0ATE.FLA3 BIT CD? 



The Indexed Sequential file system maintains two fields in the 
OFH. EXTENSION of each file which keep track of available space 
within the Oirect file. This available space should not ba 

confused with the available disk space that is maintained by the 
system. Available space in an Indexed Sequential file or in a 

Relative file aeans that a record has never been written into an 
available record slot or that a record was written at sose tine 
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the space ai located to the file is 
available* 
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P. 5 



To the systew* all 
in use and none of it 



of 
i s 



8oth of the available space pointers shown above* 

DFH. IS. NEXT. FREE. RECORD and DFH. IS. NEXT.FREE. SLOCK* will contain 
addresses of blocks which have available space. The 

N£XT. FREE. RECORD pointer does not actually point to a record but 
points to the bloc* which contains the available record slot. 
Record slot allocation within a block is accomplished using the 
presence bits in the Block Control Information for that bloc*. 

The DFH. IS. NEXT. FREE. BLOCK field will contain the area and block 
number of the next totally available block at the logical end of 
the file- The first disk area of the data file is allocated when 
the file is first opened and the NEXT. FREE* SLOCK field is set to 
zero* a valid address* at that time. Also* when the file is 
first opened* the NEXT. FREE. RECORD field is set to 3FFFFFFFFS. 
When the Micro HCP needs to add a record to the file ard the 
N£XT.FRE£.fl£CORD field contains ZFFFFFFFFZ* it leans that no 
records are available in a block that has already been 
initialized. The allocation must be accomplished using the 

NEXT.FREE. BLOCK field. 



The Micro HCP will then initialize the Presence Bits in the 3lock 
Control Information of the block addressed toy the NEXT.FREE.8L0CK 
field* move the address which is in the NEXT. FREE. RECORD field* 
in this case 3FFFFFFFF2 to the first thirty-two bits of the last 
record slot in the block* wove the address of this block to the 
NEXT.FREE. RECORD field and i ncrenent the NEXT. FREE .8L0CK field. 
If the incremented value of the NEXT. FREE. BLOCK field causes this 
disk area to exceed the specified size of a disk area* 2FFFFFFFF2 
will be stored in the NEXT. FREE, 8L0CK field instead. The use of 
this value is discused in a subsequent paragraph* 



The record which is being added is then moved to the first recorJ 
slot in the newly allocated block* the presence bit for this slot 
is set and the block is written. The presence bits for the 
second and all subsequent record slots within that block Hilt be 
set to zero* due to the initialization process. ^FFFFFFFF2» the 
value that was previously in the NEXT. FREE. RECORD field* will be 
stored in the first thirty-two bi ts of the last record slot in 
the block. 



When the next record is added to the file* the Micro WCP will 
again examine the NEXT. FREE. RECORD field and it will now contain 
the address of the blocic that was Just allocated. The Hicro HCP 
will read the block into ssemory* if necessary* and examine the 
Presence Bits in the Block Control Information. The first 
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available record slot will be the second slot within the block. 
The Presence Bit for this slot will be set and* if this is the 
last record slot in the block* the 3FFFFFFFF3 stored in the first 
thirty-two bits of the record slot will be ftoved back to the 
NEXT. FREE. RECORD field* and the record wili then be stored ir the 
slot. If the second record slot is not the last in the block* 
<3FFFFFFFF3 will remain in the actual last slot and the 
N£XT*FRE£*R£CORD field will not be changed* 

Allocation in the Direct file will proceed in this tanner* 
asuaing that no DELETE operations are perforned* until the disk 
ar ea becomes fitted and* as mentioned previously* 3FFFFFFFF3 is 
stored In the N£XT*FR£E. BLOCK fields This value serves as an 
indicator to the Hicro HCP that the next disk; area has not yet 
been allocated by the S.HCP. &hen the Hicro HCP encounters this 
value* it tserely passes control to the S.HCP which wilt allocate 
the area and store its address in the dis* file header and in the 
NEXT*FRE£*8L0CK field. The Hicro HCP will then initialize the 
Block Control Information and proceed as was described 
previously* 

The process Just described say be interrupted by the occurrence 
of a DELETE request fro« a user* When this occurs* the address 
in the N£XT*FR££. RECORD slot is stored in the first thirty-two 
bits of the record being deleted* the Presence Bit associated 
with the deleted record is reset and the block is written to 
disk- The address of tne block which contains the deleted record 
is then stored in the NEXT.FREE.RECGRQ field. The next time a 
record is added to the file* it will consequently be stored in 
the area occupied by the record that was fust deleted ard the 
NEXT*FRE£* RECORD field wilt be restored to its prior value* This 
operation should eliminate the need to periocicalty rewrite the 
entire fiie to eliminate large nuatbers of e*pty record slots* i 
process commonly fenown as "garbage collection*'* 

Should lore than one record in a block be deleted* the Hicro HCP 
only needs to insure that the first thirty-two bits of the last 
available record slot in that block contains the address of the 
next block in which a record slot is available or 3FFFFFFFF2 if 
there is no such next block* This is true even if alt of the 
records in a block are deleted* Ho pointers need be changed* in 
this tatter case* until the next DELETE operation occurs. 
Assuming that no new records hawn been added in the inter is* the 
Micro MCP then needs only to insure that the address of the block 
which is totally e&pty is stored in the slot previously occupied 
by the deleted record- 
Allocation of space for an Index file associated with an Indexed 
Sequential file is somewhat stapler than for a Data file* since 
record availability does not have to be maintained. Whenever a 
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record Is deleted* the pointer to that record in the Index fite 
is destroyed and the table contained in the block is compacted. 
The count of the actual number of entries in that block* which is 
maintained in the Block Control Information of an Index filer is 
decremented- No other action is required for the Index file- 
Maintenance of the NEXT*FRE£* BLOCK field of an Index file is 
exactly tike that for the data file. This field will always 

contain the address of the next available block at the logical 
end of the file. The Micro HCP will set the field to 2FFFFFFFF2 
when the next disk area must be allocated* exactly as is done for 
the data file. 

The NEXT*FRE£*RECORD field is used to address a linked iist of 
blocks within the file that are completely empty* This can only 
occur when all of the records that were addressed through this 
block have been deleted* a situation which should seldom occur in 
actual use* 



The "splitting"' of fine tables in the Index file is an operation 
that is always performed by the S.MCP* Any time the addition of 
a record to the file causes a need for a fine table to be divided 
in two* the Micro HCP passes control to the SOL portion. 

Consequently* the >.5_gJ(CP per focus lost of ±iis_ ava ijLab I e space 

ma i n t e na ac e .for ._ t h e_Jmlfl.iL_i J las * ..._ w h its the * i cc o M C P p er f or m s the 
majority of this work for the data file, 

£U££AD£ Isfiima Shiatsu L&MMM1 

The CURRENT is a structure that* for ANSI *7h C880L* logically 
belongs in the User Specific Information field* since there is 
only one CURRENT per user* There are two reasons for associating 
the CURRENT with the Structure Descriptor* however. First* ONS 
has a CURRENT for each structure and a pointer exists in each 3TR 
to the appropriate CURRENT* To be compatible with QHS* each STa 
of an Indexed Sequential file points to the CURRENT for that 
structure* A current structure number is maintained ir the USI 
to satisfy ANSI *?4 requirements* Second* since the file can be 
shared* an operation by one user can affect the CURRENT of 
another user* To guard against this* each CURRCNT is checked 
when an operation which can affect it is performed* To aid the 
search of CURRENTS* they are linked together* the first one being 
pointed to by the 5TR* A programmatic description of the CURRENT 
field is presented below* 
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01 CURR£NT..DECLARATIGN# 
02 CUR. LINK 

CUR. JOB. INVOKE* 

03 CUR. CUR. JOB 

OS CUR. CUR. INVOKE 

CUR.STATUS 

CUR. FINE. TASLE* 

03 CUR. AREA 

03 CUR. BLOCK 

03 CUR.RECORO 

CUR. STATISTICS* 

03 CUR. SIR. REAO. COUNT 
CUR. STR. WRITE. COUNT 
CUR. STR. RE WRITE. COUNT 
CUR. STR. DELETE. COUNT 
CUR* STR. SPECIAL. COUNT 
CUR.STR.EXCEPTION.CGUNT 
CUR. SIR. PHY. RE AD. COUNT 
CUR. SIR. PHY. WRITE. COUNT 



02 



02 

02 



02 



03 
03 
03 

03 
03 
03 
03 
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81T<24>* 

aiTC16)» 

8ITC6).* 

8ITC23* 

8IU8)* 

BITCiS)* 

8ITC12)* 

8ITC241* 
BITC24)* 
8ITC24)* 
8ITC243* 
8ITC24)* 
3IH24)* 
BITC24)* 
8ITC24)* 



X O-DEL* l-VAL 



£yiSDII J&ifl££J3ti3£S 



The current is mai nt ained for Indexed Sequential files which use 
either Sequential access or Oynafflic access. When the user is 
accessing the file sequent* iatl y* the current is maintained for 
the key' of reference 



the key of reference 
points to the last 
initialized to point 
indicate the entry 
op ened OUTPUT ^XIPUl* 
entry written. The JHcro 
insure that records 
ANSI 74 COBOL. 



<USI. CURRENT. STRUCTURE). For output files* 

raust be the prime key and CURRENT always 

entry written. For a new file* CURRENT is 

to the first entry but CUR. STATUS is set to 

has not yet been written. For an old fits 

the current is JnitL&lJxed to the last 

HCP uses the current on output files to 

are written in sequence* a requirement of 



Seauential IMPUT or I tl£liJrJQyjPttI--iiJU3Lr«auira that the current 
pSinlHo^^ the next READ operation, t a 

current is incremented to point to the next available record. If 
the current record is deleted or the CURRENT was *«"«•«•***■; 
OPEN or START* then CUR. STATUS is set to indicate that a record 
has not yet been read. The next READ wilt deliver the record and 
reset CUR. STATUS. 



For files in 
complicated. 
of Sequent! 
sequences of 
result. The 



Dynamic access ffiode* the meaning of CURRENT is tore 

The CURRENT will be handled exactly as in the case 

it INPUT or INPUT -OUTPUT. This leans that sotse 

operations nay not produce the desired intuitive 

example below illustrates the pr obtes. 
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Consider the Index table at the right. * -< ♦ 

What should the result of a READ NEXT I ABLE I 

be* In the following sequence of operations? I DOG J 

I GOLF i 

a* REAGCASLE)* ADOCBAKEiR)* REAO NEXT; ♦ --- ♦ 

0. HEADIOOG}* 0ELETEOQGJ* ADOCECHG)* SEAO NEXT; 
C. HEAOOOG)* 0£L£T£(D0G>* AOQCCHAHLIE 5* REAO NEXT," 

For our implementation the REAO 8EXT produces the foil owing 
result ss 

a. 8AKER 

b. GOLF 

c. GOLF 



Intend 2&2u&QXial Muiistz. iLaiiassisM 

The method of allocating buffers in prior versions of the ntP and 
in the 9*0 version for Conventional files Is known as Static 
allocation. This method of allocating buffers is simple* once 

the number of buffers has b^^n chosen by the user- The buffers 
are merely allocated when the file is opened and they remain 
assigned to the file until it is closed. If the number of 

buffers allocated is too small* however* then operations upon the 
file way be inefficient. If the number of buffers allocated is 
too large* then nothing is gained in efficency and memory space 
is wasted. 



On an Indexed Sequential file particularly* the number of buffers 
actually needed varies with the type of operation and the state 
of the Indexed Sequential file. The optimum number of buffers is 
best._..chos*n__ dynamically to avoid the di sadv ant ages Irent ioned" 
above. "" ™ — - 



Allocating buffers on detsand and deallocating then when the 
memory they occupy is required for other purposes is known as 
glut amic allocat ion^ Dynamic allocation has always been uted for 
buffers associated with a QHS data base. It is accomplished by 
calling the ftCP»s memory allocation procedure* GETSPACE# whenever 
a buffer is required. Deallocation is accomplished by allowing 
GETSPACE to overlay OHS buffers when necessary. Dynamic 

allocation has also been implemented for Indexed Seouential 
f i les. 



The management of buffers associated with an Indexed Sequential 
file presents a soecial problem for the HCP* since there can be a 
variable number of them* depending upon the operation* arid they 
can be different sties* depending upon which component file is 
being accessed. To solve the problems associated with a variable 
number of buffers* the Prioritized Memory Management algorithm* 
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developed for the 7.0 release should be used- This ie»ory 

manager overlays buffers whenever space is needed ard the 
priority of a buffer makes it a candidate to be overlaid. The 

FIFO Heaory Hanaqement algorithm can be used but perfomarce may 
be impacted on a «ul ti -progr amrai ng system. 

To solve the problems associated with variable size buffers 

addressing the same Indexed Sequentia* file* alt of the buffers 

used for one structure are linked together and pointed to by tha 

structure* so that ail buffers in a chain are of the saaie size. 

intend Ssaj-sBitiii IMfsc £sis£i2is£ imi 

The Buffer Descriptor is the structure used to maintain the 
buffers associated with the Indexed Sequential file. It contains 
the necessary link fields* identification fields* and state 
information. Since the memory manager may overlay the first 
buffer in a chain* the memory link field* ?4L. POINTER* wilt 
contain the structure address so that STR.BUFFER.LIST. POINTER way 
be updated. A programmatic description of the Buffer Descriptor 
is presented below. 

01 8uTF£R_D£SCRIPTQR* 

02 SD. AREA. DISPLACEMENT* 

03 60. AREA BITC8)* 

03 SO. OFFSET BIU16)* 

02 BO. USER. COUNT 8ITC*)* 

02 8D*IN. MEMORY BITCD* 

02 BO. 10. ERROR BITCD* 
02 BO. WRITER. CONTROL* 

03 3D. REQUIRES. A. WRITE BITCD* 

03 80. CONTROL. POINT BITCD* 

02 30. NEXT. BUFFER. DESCRIPTOR 8ITC24)* 

02 BD.PRIOR.BUFFER. DESCRIPTOR BITC24)*" 

I/O descriptors are shared among ail the buffers. The BEGIN and 
END addresses in the descriptors may be sodified when a 
descriptor is used by the Operating Systes. The nussber of 

buffers allocated depends on the number of active structures 
associated with the Indexed Sequential file. This technique 

serves to minimize the number of descriptors in the disk chain* 
thus reducing the afflount of processing required by GISHG* and it 
minimizes the iseaory requirements for descriptors. It does 
require an allocation nechanism for descriptors* in addition to 
one for buffers* but this expense has been found to be north the 
benefi ts. 
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c °- n cJffiH ent REAP operations o n the _ same record of an Indexed 

Seguenti at fijlo are a lw ays al lowe d - Foir the 9*0 ~v er s Ton 

softwaTe* at* logical update operations* WRITE and REWRITE* 
be started only after alt accesses to the file 
suspended* These update operations will Inhibit further accesses 
to the file until they complete. To users* it wilt appear that 
concurrent updates to the file are allowed* thouch this will 
actually- be the case. 



of the 
Mill 

have been 



not 



This restriction simplifies the code necessary to insure that the 
appropriate buffers remain if! memory* Since only one update 

operation can be in process at any given time* the update 
operation will begin with a BO. USER. COUNT of lera* O nce the 

up da t e o per at j [on u se s a_buf f .er#_ t ha£__bu f f er * s user c©ii n t "will to 9 

sft_t-..-ta_one_» thus preventing the H e m or y ~ Ha nag e m a" n t algorithm from 
overt ay ing. it. ~~ " ~ ' ■ — ■■- ■■ ■ 



Upon completion of the update operation all user counts kilt be 
set to srero. For READ operations* the user count field is not 
used because each buffer need be used only once during the 
process of the commun icat e. The buffer is automatical I y 

protected from being overlaid while the I/O operation is in 
process. 

The code necessary to insure the integrity of the file is also 
simplified. The Record Contention problems* the complex problems 
involving changes to the file while another user is accessing it* 
are avoided. For the simple case of one user at a time updating 
the file* The simplified code provides better perf or nance. 

The disk I/O error procedures in the MCP perform a certain number 
of retry operations each time a disk I/O operation completes with 
the Exception Bit* Bit 1 starting from zero* set to one. 
different procedures may be invoked* depending upon the type of 
I/O operation that has completed and the type of control and 
drive that encountered the error. MCP I/O operations are handled 
by a different procedure which is not as extensive as the one 
described below. The following description applies to I/O errors 
on user I/O operations only. 



The I/O error procedure first checks the Hemory Parity Error bit* 
Bit 5 i n the Result Descriptor* received from the control. If 

the bit is on* it performs a maximum of three retry operations* 
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without investigating 



The procedure next checks the transmission Parity Error bit* Bit 
15 in the result descriptor* If this bit is on and if the unit 
being used is not a 89482 disk cartridge* the procedure performs 
a maxiaiui of three retry operations* logs the result ary^ exits 
the procedure without checking any further. If the unit is a 
89482* no retry operations are performed for this case but and 
the investigation continues* 

The procedure next checks the Not Ready bit* Bit 2 in the result 
descriptor. If this bit is on* the procedure performs a ffiaxi«ua 
of three retry operations* logs the result and exits tba 
procedure without checking any further. 

The procedure next checks the Write Lockout bit* Bit 6 in the 
result descriptor* If this bit is on* The procedure iooks at the 
I/O descriptor itself* If the first three bits of the operation 
code am 010* Oil or 101* which would denote Write* Initialize 
and Relocate* the procedure performs a aaxtvus of three retry 
operations* logs the result and exits the procedure without 
checking further* If the first three bits denote something other 
tnan the three operations listed* Bit 6 is ignored ard the 
investigation continues. 



The procedure next performs a Logical OR operation on: 

Bit 10* 



1. The Sector Address Ermr bit* 

2. The Seek Tineout bit* Bit 11* 

3. line Address Parity bit* Bit 9* 

4. The Data Error bit* Bit 3. 



AN0 not 89482)* and 



If the result of the Logical OR operation is true* the procedure 
becojies cofflplex and varies with the type of disk connected. 
Before describing the procedure for each type of disk* some basic 
procedures should be described. 



Ihs. Mlssx Etfissitycjg 



The Offset 

procedure.. 



Procedure is a subroutine of the disk 1/0 Error 

... _. Basically* it performs six retry operations. If any 

one of the six effect recovery of the error* the procedure is 
exited immediately regardless of how many operations have been 
performed. The term "offset** as used here denotes positioning 
the disk heads slightly off of the center of the cylinder 
specified in the disk address. In all disk pack drives which 
be connected to the 81000 system* offset may be 



specified in 



aiay 
the 
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inward C positive) or outward € negative J direction* 

The first two operations requested by the Offset Procedure are 
performed with the original I/O descriptor unmodified. The neit 
two operations are performed with negative offset and the last 
two are performed with positive offset. If recovery is not 
effected by any of the six* all bits which may have bee* set in 
the original I/O descriptor to cause the offset operations are 
reset and the procedure is exited. 

The tern "strobe* as used here denotes beginning the actual read 
operation stigtly before or after the point in the rotation °f 
the disk where it would normally begin. The Strobe Procedure 

calls the Offset Procedure a saxiatun of three tiroes. This may 
cause a aaximuffl of eighteen retry operations to be performed. it 
any one of the eighteen effect recovery* the procedure is exited 
regardless of how many operations have been performed- 



original I/O descriptor in its 
six retry operations to occur* 



The first call on the Offset Procedure is accomplished with the 

unmodified fom. This will cause 
exactly as described for the 

the 
tie 
descriptor which will cause early strobe to occur* Hence, 
another six retry operations may be performed* two with ««*iy 
strobe and no offset* two with early strobe and positive offset 
and two with early strobe and negative offset. 



Offset Procedure* provided recovery is not effected by any of t 
six. The next call is accomplished with a bit set in t 



Twelve retry operations have been performed to this point. If 

the error has not yet been corrected* the Offset Procedure is 
aqain called with bits set in the I/O descriptor to cause lata 
strobe to occur. This say result in another six retry operations 
being performed, as described for the Offset Procedure* all with 
bits set in the I/O descriptor to cause late strobing to occur. 



alt 

ard 



bits 

the 



If none of these eighteen operations effect recovery, 
which say have been set in the f/O descriptor ^re reset 
procedure is exited. In the Strobe Procedure and in the Offset 
Procedure, if any retry operation does effect recovery* the I/O 
descriptor resposible is entered in the log prior to exiting the 
Procedure. 
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Alt varieties of d i sit pack that may be connected 

system and some varieties of di sk cartridge 

correcting capabilites in the form of a Fire 

stored immediately after the 1440-bit data 

remainder is fifty-six bits In length on the 207 

thirty- two bits in length on at 4 others. It 

stored by the disk hardware when the data segment 

an error should occur when the data segment is read* 

it should have been written may be reconstructed* provided at 4 

the bits in the data that are incorrect reside in the saie 

•burst* of bits and provided the length of this burst does not 

exceed a specified limiting Rubber of bits. 



to the 81000 

include error 

Code remainder 

segment- The 

disk pack and 

is computed and 

is wr i 1 1 e n . If 

the data as 

of 



The Error Correction Procedure obtains a 2*08 0-bit buffer from 
available memory* If such memory is not available* the routine 
exits without attempting to correct the error* In all cases* 
when error correction is performed* all of the segments described 
by the original descriptor atB read and corrected one sector at a 
time. For all disk devices which store the 32-bit remainder but 
which do not have the ability to correct burst errors in input 
data* the procedure must operate in this manner. Devices which 
are capable of performing error correction* such as the 207 disk 
drive* ^re capable of doing so on multiple-sector read 
operations* but this feature is not utilized by the software. 
Rather* all of the sectors are, ( read one sector per operation and 
the exact addresses of all • failed sector s are logged. This 
information would be lost on a . iulti pie-sector read operation. 

Error correction is performed by the software for all varieties 
of disk pack except the 207. The 207 hardware includes error 
correcting capabilities. Error correction is also performed by 
the software for the 89482 Oi sk Cartridge. The software is 
capable of correcting a six-bit error burst. The 207 hardware is 
capable of correcting an eleven-bit burst. 
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Two different varieties of 215 and 225 disk 'pack drives have been 
delivered during the life of the 6100,9 hardware. These varieties 
are known as Design Level One COL- 1)- and Design Level Two C0L-2I. 
For both varieties* the Strobe Procedure is invoked but there are 
some operational differences in th$ hardware itself* On 0L-1 
drives* the bits which cause plus ani minus offset and early and 
late strobing are ignored bf the hardware* since it does not 
include these capabilities. Consequently* on 0L-1 drives* a 
total of up to eighteen retry operations will be performed by the 
Strobe Procedure* but they will actually be nothing more than 
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eighteen repetitions of the original I/O descriptor. DL-2 drives 
include a full complement of offset and strobe capabilities. The 
software cannot distinguish between the two types of drive. 

If none of the eighteen retry operations caused by the Strobe 
Procedure effect recovery* the I/O descriptor is restored to its 
original state* and the Error Correction Procedure is invoiced* 
Each sequent described by the I/O descriptor is read individually 
and error correction is performed* if possible* by the software. 
In all cases* the results of the recovery attempt are entered in 
the Engineering Log* 

Saia ami iildOLsa £1x111: ftafioxscx z £95 kn& ZM Q£l*&s 



for 205 and 206 disk drives* 
exactly as it is described, 
performed* two operations with 
strobe and offset variants. If 
recovery* the I/O descriptor 
condition and the procedure is 



the Strobe Procedure is performed 
Eighteen retry operations are 
each possible combination of the 
any of these operations effect 
is restored to its original 
exited* If not* the Error 



Correction Procedure is invoiced with the I/O descriptor in its 
original condition* Error correction is performed by the 

software for 205 and 206 drives* 



In any case* the results of the recovery attsapt will be entered 
in the Engineering Log prior to exiting the procedure* The I/O 
descriptor is always restored to its original condition prior to 
exiting the procedure* 
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207 disk drives include neither offset capabilities nor strobe 
capabilities* The hardware does inclucfe a capabilty to vary the 
threshold of a read operation but its uSris not recommended for 
recovery purposes by the manufacturing plant* Consequently* the 
Strobe Procedure is not invoked for 207 drives. t m q retry 

operations only are performed* both using the original version o 
the I/O descriptor* If either operation effects recovery* the 
results are logged and the procedure is exited* If not* the 
Error Correction Procedure is invoked. 



207 drives include error correct ing^capab il i t ies in the hardMare* 
Additionally* the hardware! is capable of correcting all errors 
that are correctable in all sectors described in one ffuttfple 
sector operation- This multiple sector capability is not 

utilized by the software* however* and each sector is res6 and 
corrected individually. This is done for diagnostic purposes 
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only* to isolate the address of the failed sector CsJ and Insure 
their entry in the Engineering Log* The results of the recovery 
attempt will be logged and the procedure wilt be exited with the 
I/O descriptor restored to its original condition* 

&§I3 iad i&lnasi £££££ £££2*so z Mai £j£Jxiite£J 

For alt versions of disk cartridge except the 89*82* the 4400 
8PI* 203 or 406 track* 64 sector per track variety of cartridge* 
the error recovery procedures are very simple. The procedure 
merely repeats the original operation a maximum of three times. 
The results of this attempt are togged and the procedure is 
exited with no further checking. There are no other options 
available in the hardware which might help in the recovery 
at tempt - 

For the 89482 cartridge* the recovery attempt is slightly more 
extensive* This drive has error correcting capabilities siailar 
to those of the 206 drive. Error correction on a ftead operation 
is performed by the software in the Error Correction Procedure 
exactly as it is described. On a Write operation* the recovery 
attempt is actually lore complex than for a disk pack*, 

When a Write error occurs on the 39482 cartridge* the I/O Error 
procedure will attempt to correct the error* if the three retry 
operations mentioned above fail* by writing the data one sector 
per operation. In the case of an Address Parity error* the 
procedure will also attempt to write that sector plus the 
preceeding sector in an effort to correct the address parity. 
The results of the attempt wilt be logged and the procedure will 
be exited when recovery is effected or when all retry attempts 
have been completed. 

This concludes the discussion of Oata and Address Error Recovery 
for the various drives that may be connect. The remainder of 

this section describes the remaining tests in the I/O Error 
procedure. 
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If the results of the Logical OR operation mentioned previously 
were false* the I/O Error procedure examines Bits 22 and 23 of 
the result descriptor. If both bits are set to one* they 
indicate that an Extended Result Descriptor was returned with the 
operation* though the ERD may not be stored in memory. The 
procedure stores the Extended Result Qescriptor* if it is 
available* in the Engineering Log and performs a maximum of three 
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retry operations using the original I/O descriptor* The results 
of the attempt are logged and the procedure is exited with no 
further checking. 

Finally* if ail of the tests mentioned to this point were false* 
the procedure performs a waximua of three retry operations and 
logs the results* Since an exception did occur* indicated by tha 
setting of Bit 1* the data is assumed to be corrupt and an 
atteapt is made to correct i t. 
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There is one I/O Error procedure that is invoiced for all tape I/O 
operations that complete with the Exception bit in the result 
descriptor set- The procedure is invoked regardless of whether 
the operation was a user I/O or an MCP I/O, It is also invoked 
on the completion of Test operations* where the setting of the 
Excepton bit is a normal occurrence. It is also invoked for 
Emulator Tape operations* though in this case* it may do nothing 
more than pass the result descriptor on to the user for 
resolution* 



Essentially* the procedure will retry the operation a fixed 
number of tiises and return control to the procedure which called 
it- If recovery was effected* this will be so indicated in the 



previously failed result descriptor upon return* 
procedure was not able to effect recovery* the result 
will contain an indication of the failure upon return- 
instances* the procedure will retry the operation ten 
this number wi'41 vary with the type of failure at\4 the 
attempted* 



I f the 
descriptor 

In »ost 

tiaes* but 

operat ion 



The Tape I/O Error procedures will be 
subsequent version of this specification* 



described fully In a 



<*-l 
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This section of the specification has two principle parts. 
S-memory management is described at the functional level. 
S-memory requirement s for a given system configuration are tnen 
presented- Using the second part of this section* it shculd be 
possible to estimate the amount of S~memory that will be required 
on a system to support a given pro gran* 

S-memory management techniques were changed drastically in the 
7.0 version of the software and were changed again In the 9.1 
version* The discussion contained in the first part cf this 

section nay not be applicable* in all cases* to versions of the 
software released prior to the 9.1 version. 
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The B4000 software utilizes 
management* In such a system* 
only when it is required and ow 
satisfy the request. In other 



a "segmentation* for* of memory 
memory is requested and allocated 
y in the amount that will exactly 
words* memory is divided into a 



variable number of segments* each of which is of any size* with 
some obvious restrictions. A basic element in this form of 
memory management is the "memory link". 



The format of the memory link was presented in a prior section. 
Basically* it contains a size field which may contain any value 
from zero to 16*fFf*2l5 bits. It contains the addresses of the 
memory links that precede and succeed it and the address of an 
associated segment dictionary entry. It contains a number of 
other fields* which will be discussed in turn. It is created and 
maintained by the MCP and the executing interpreters store 
selected information in it. In all cases* it immediately 

precedes the segment of memory that it describes. 
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Contiguous blocks of memory are reserved for system use at the 
extreme ends of the memory on any system. This is described in 
more detail in the second part of this section. Between the t*a 
contiguous blocks lies the area known as "linked memory*. At the 
end of the reserved area at the low end of memory* there is a 
dummy memory link known as the Lower Terminating Memory Link 
CLTML). At the beginning of the reserved area at the upper end 
of memory is the Upper Terminating Memory Link CUTMLJ. 
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The terminating memory links are created during the Clear/Start 
procedure. Each has a size field. of zero* a type field which 
specifies the area as T£RMIIfAT{*G«LXNK» but the "save* bit wilt 
be set to one in both links. This allows the memory management 
procedures to recognize the terminating memory tlnlcs. The 
backward pointer in the LTML will contain 3FFFFFF3? but the 
forward pointer will contain the address of the next memory link* 
in address order. Similarly* the backward pointer in the UTML 
will contain the address of the previous memory link in address 
order; the forward pointer will contain 2FFFFFF3* 

Hence* all memory links form a chain in memory. The memory link 
which immediately precedes each allocated memory area will 
contain the address of the succeeding and preceding memory links 
in the forward and backward pointer field respectively* The 
chain will be terminated in the forward direction by the upper 
terminating memory link and in the backward direction by the 
lower terminating memory link. 



The area known as linked memory is 
subspace"* as this term is used herein* 
memory subspaces withir linked memory 
CBase/Limit area) of certain programs may 
allocated upon request by the software. 



an example of a ^memory 

There may be other 

The Run Structure 

also be divided ard 

The same procedures in 



the software are used to manage these smaller memory subspaces as 
are used to manage I inked memory. 



II££3 2£ BZMB1 l£lli£Hl 



Memory requests may originate in a number of diverse manners. 
This is evidenced by the large number of "different values the 
type field of a memory link may contain. The most common 
occurrence of a memory request is for a code segment to be 
brought into memory. Other requests originate when a file is 
opened* when the MCP needs additional temporary storage for the 
performance of one of its tasks* when additional space is 
required to hold a queue message* and so forth. 



There is probably no need to discuss each different type of 
memory request. Many of the numbers assigned to each different 
type of memory request are for the benefit of the Oump/Anal yzer 
program only and have only pathological use. The different types 
of requests have common characteristics and may hence be grouped 
into ^classes*. The common characteristics will be described and 
explained. 
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Parameters that are passed with a memory request are the size of 
the required Memory ares in kits* the address of the dictionary 
entry which will be associated with the memory area* if any* the 
address of the Hun Structure Nucleus of the program which caused 
the request* if any* the type field to be stored in the nenory 
link* the priority of the request* a boolean variable *hich 
specifies that the memory should be allocated at the highest 
possible physical address and a boolean which specifies that the 
memory must be allocated above the "fence". 
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The NCP has one set of stacks* only* to store the variables that 
it must manipulate in the performance of ' any 'function* This set 
of stacks cannot be stored anywhere else? they fust be 
maintained in memory until the function has been performed. 
Consequently* once the HCP begins performing any function* it can 
perform no other function until the original task is complete* 

Almost all HCP functions require more than one HCP code segment 
to complete* A file Bpen may require aidre than thirty code 
segments to be brought into memory* The number of code segments 
required could obviously be reduced by making each code segment 
larger but this would also reduce the possibility of finding 
sufficient memory on smalt systems* It would also possibly cause 
more user code segments to be removed from memory to make room 
for the larger HCP segment* 

Should the HCP begin performing a certain request and not be able 
to find sufficient memory to contain a necessary code segment* 
the system would fiaye to halt. A Clear/Start would then be 
required* with its resulting loss of all programs that were 
running at the time* In order to insure that there will always 
be sufficient memory to hrinq in the largest HCP code segment* a 
fence is established in memory* below whicl only code segments 
are allowed to reside* The location of the fence may be 
calculated by adding the size of the largest &CP code segment and 
its associated segment dictionary to the address of the tower 
terminating memory link* 

Certain exceptions to the statements in the par agr aph above 
exist* Code segments may not be" over : l arable" a t at I ti mes* To 
bring a code segment into memory* the -.memory area is allocated 
and an l/Q operation initiated* The memory area may not be 
deallocated until the I/O operation is complete. Should the MCP 
encounter such a situation and not be able to find a required 
memory area anywhere else in memory* it will wait for the 
completion of the operation* 
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Certain code segments associated with ni£H applications programs 
are also not overlay able* This is also true of segments of the 
interpreter used by such programs. Consequent! y* the fact that a 
memory request is for s code segment is not sufficient to 
determine whether the memory should be allocated below the fence 
and the boolean variable is required* 



Checkerboarding* also known as External Fr agmentati on* is the 
condition which exists when memory contains a targe nuiber of 
permanently-allocated areas* or "save" areas* most of which are 
separated by ssiall overlayable areas* In such a situation* the 
total memory available may well be large enough to satisfy a 
given request but no single contiguous overlayable area is 
sufficiently large* This situation can have a serious impact 
upon performance* 

To minimize the possibility of the occurrence of checkerboarding* 
the HCP attempts to allocate all memory denoted as 
non-overlayable or "save" at the highest possible physical 
address. Examples of items which are so allocated are program 
run structures* files and I/O buffer areas* 
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When a request for memory allocation is received* the sanagement 
algorithm must select a *victim w * a portion of memory which is 
already allocated which may be deallocated and assigned to 
satisfy the new request* The area to be allocated may also be 
marked Available* of course* though this is seldom the case. 
"Victim Selection* is the process of determining which allocated 
memory segment or segments will be deallocated* This is the most 
intricate task of the management algorithm* the task which 
requires the most attention to strategy and the task which is 
most influential upon the performance of the system* Two victim 
selection algorithms are provided in the software. Users may 
choose either the priority Victim Selector or the Second Chance 
Victim Selector via a system option* The change is only 
effeccted during a Clear/Strat operation* 
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Prior to the 7*0 release* victim selection was essentially a 
round-robin among requests* The MCP kept a pointer which served 
as the starting point of each search and was updated after each 
allocation to point to the end of the newly allocated area. This 
pointer is typically referred to as the *left-off pointer*. The 
round-robin algorithm had the advantages of being computat ional t y 
simple and it served to minimize external fragmentation* but 
there are some serious disadvantages associated with this victim 
selection algorithm* Specifically* 



It has no knowledge of which segments are 
elements of the "wor Icing set"* and 



actually in use* 



2* The memory resources of each job have equal importance. 
Unlifce processor scheduling* the memory is not allocated on a 
priority basis* 

These flaws lead to some bad performance degradations in certain 
situations* One such problem is the "cascading* phenomenon* 

Using Denning* s definition* a program's working set WCT* tl is 
the set of all segments accessed bf the program in the interval 
£T-t* Tl* Denote the 'size of this set (in HCPIf context* size is 
in bits>* as VKT* tl* This definition affords us useful 

information with which to manage real store whenever the change 
C*drift*J from the set W0CT0* tl to the set W1CT1* t) is small 
for the interval UG* T13. The assumption behind working set 
management is that for many programs* the drift is indeed smalt 
during most of their execution lifetimes. 



Postulate a situation where the code and dictionary segments of a 
single fob completely fill overlayable memory. The round-robin 
algorithm* having no information concerning WCT* tl made a choice 
of victims among the resident segments which was essentially 
random with respect to this information* Call the ratio 

WCT* t)/lsife of overlayable memory) the saturation ratio S. 
Then the probability is approximately S that the incoming segment 
wilt overlay one or more elements of WCT* tl. The overlayed 
segment* of course* will immediately be needed again and has a 
probability of about S of overlaying another element of W€T# t)* 
This sets up an undesirable oscillation which should eventually 
damp back to stability* assuming no further external 

perturbances* The probable number of extra overlays required to 
reach stability increases with 5* and becomes quite large when $ 
exceeds* say* 0*9* He call this oscillation "cascading* of 
overlays* For large values of S* almost all time is consumed in 
waiting for I/O on the backing store* so very little wor* gets 
done* This is the situation commonly known as "thrashing". 
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Now* suppose the memory manager has some knowledge of the 
elements of Mil* tK If the saturation ratio is not too close to 
one» It will usually be possible to select" a window containing no 
element of WiT* t>. The chance of cascading segments is thereby 
decreased in configurations running with $ in the range of 0.5 to 
0.75. The difficulty is that elements of WCT* t) now clutter 
memory and increase external fragmentation* As S approaches Cer 
exceeds! one* this becomes an important loss and makes selection 
difficult for the memory manager. At this point* the advantages 
of the round-robin strategy begin to outweigh the advantages of 
utilizing worfcing set information. 
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in order to determine whether or not a code segnent in meiory is 
currently being used*- usage bits were added to the memory link in 
the 7*0 version of the software* These appear in the 

programmatic description of the memory link as 

HL*P«EVIOUS*SCAM*TQUCH and HI. CURRENT. SCAN. TOUCH. Whenever an 
interpreter accesses a code segment dictionary entry and finds 
the associated code segment present in memory* it sets the 
current scan touch bit to a value of one. Interpreters make such 
an access whenever they are reinstated and whenever a code 

is not necessary for interpreters 
which are associated with segment 
y marked as save space if any cf 
in memory-. Also* data segments 
are always overlaid in a round-robin fashion* regardless of the 
victim selector that is currently being used on a system. 



segment transition occurs. It 
to set the bit in memory links 
dictionaries. These are usual 
their code segments are present 
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The Second Chance victim selection algortihm* first introduced in 
the 9*1 version of the MCP* addresses the first failing of the 
round-robin algorithm* the lack of knowledge of the working set 
of the code being used. Also* the Second Chance algorithm 

completely supplants the old round-robin strategy* The latter is 
no longer available for use. The change is completely 

transparent to users and the only noticeable effect should be an 
improvement in performance in installations where the round-robin 
algorithm was used prior to release of the 9.1 software. 



The Second Chance algorithm utilises the left-off pointer 
described for the round-robin algorithm. It begins searching for 
a memory space large enough to satisfy the request at the 
left-off pointer but it will not select any space whose touch 
bit* ML. CURRENT. SCAM. TOUCH* is set. Upon encountering a memory 
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segment whose touch bit is set* it resets the bit and continues 
to the next memory link. It will allocate tha first segment it 
encounters that is sufficiently large and whose touch bit is 
reset* 

This algorithm thus has the major advantage of the round-robin 
algorithm/ it is computationally staple and the procesing 
required is minimized. Unlike the Prioritized victim selection 
algorithm described betow* it requires no knowledge or action on 
the part of the user. 

UIM111 UQIIB 5£L£HIIflJJ 

The second failing in the round-robin strategy is its inability 
to insure rapid turnaround to Jobs which are designated as high 
priority. In NCPII* prior to the f.O release* only the processor 
was allocated on the basis of priority. A high priority 

application was contending for the memory resource on exactly the 
same footing as a low priority "background" Job. This led to 

severe performance degradation for users which required many 
overlayable memory resources but frequently relinquished 
processor control to make operating system requests. In 

particular* datacomm applications running in multiple job shops 
were suffering badly. Background Jobs tended to usurp critical 
resources forcing the datacomm application to loose control stiil 
more frequently* allowing background jobs to run* grab more 
memory resources* and so forth. 

The Prioritized memory management algorithm* first introduced in 
the f.0 version of the HCP* addresses both of these problems. 
The priority victim selector makes its choices on the basis of a 
priority field in each memory link. This field is maintained by 
runtime use of working set information. The priority field will 
be maintained at its original value as long as the code segment 
is not used. This field is known as the Residence Priority field 
and is shown on the programmatic memory link description as 
ML. RES I DENCE. PRIORITY. 

Associated with each program running on the system is a Memory 
Priority field. The memory priority value determines the ability 
of the program^ code segments to overlay the code segments of 
other programs running on the system. Memory Priority is stored 
in each memory link associated with each of the program's code 
segments. It is shown programmatic all y as ML.INCGMING.PfUGRITY. 
Memory priority is also stored initially in the Residence 
Priority field. Whenever a request for a new code segment to be 
brought into memory is received* the memory priority of the 
associated program is compared to the residence priority of every 
memory link currently present in the system memory. The current 
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implementation of the victim selector always chooses a victim 
having the lowest residence priority* 

An exception must be made for MCP code segments. As presented in 
a prior paragraph* the HCP cannot be denied a requested code 
overlay without halting the system. Consequent! y* MCP code 
segments have an imperative incoming priority* but their 
residence priority value will decay at a rate equal to or greater 
than the programs running on the system. 

At a user-specified interval* a routine in GISHO known as the 
sweeper is executed. This routine moves the setting of the 
current touch bit to the previous touch bit* destroying the prior 
setting of the previous bit and setting the value of the current 
toucn bit to zero. This routine is discardable and is eliminated 
by the initialiser if the system is running with the Second 
Cnance victim selector* 



The default time period between executions of the sweeper is 863 
milliseconds. Users may vary this time period via a keyboard 
instruction within certain ranges. Since the sweeper routine may 
be executed between any two S -operations* all code in the 
software which manipulates memory links must always insure that 
the chain formed by the address pointer fields is intact. 

After the sweeper has moved the current touch bit to the previous 
touch bit* it then examines the previous touch bit. If the value 
is zero* it increments the current decay interval field* 
ML. CURRENT. 0K. INT* by the value of the sweep interval. If the 
value of the current decay Interval is equal to or greater than 
the specified decay inteval* HL. OK. INTERVAL* the residence 
priority field is decremented. 

The default value of the specified decay interval is zero. Users 
may specify different decay interval values via a keyboard 
instruction. Users may also specify' that certain code segments 
within a program are important and tha^t their residence priority 
should not decay until the specified decay interval has elapsed. 
This is accomplished via a supplied normal-state prograff whicn 
manipulates code files resident on disk* The residence priority 
of code segments which are not marked as important wilt decay 
after the default decay interval* zero seconds* has elapsed. 
Notice* however* that this cannot occur for at least one sweeo 
interval • 



When executing with the priority victim selector* the HCP still 
maintains a left-off pointer. When the system is thrashing* when 
the residence priority fields of all memory links have equal 
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continue to foe the next memory 



One of the serious problems confronting virtual storage systems 
is memory thrashing. On the 81000 system* memory thrashing 

occurs when the working set of procedures for a >~ -program or set of 
programs will not fit within the portion of main memory available 
for overlays* When this state occurs* the systems performance 
begins to degrade. The amount of degradation depends or the 

overlay space available* the size and number of segments 
competing for memory* and the frequency of segment transitions. 



As the amount of main memory is reduced for 
programming tasfc* the amount of degradation due 
overlays normally appears very gradual at first 
available memory is further reduced* a point will 



a constant 

to iaiofy 

As the 

be reached 



where the degradation due to overlays increases rapidly. This is 
the point where the main working set of procedures no longer fit 
in main memory and are competing for space. This point is 
defined as the thrashing point and Is shown in Figure 4.1. 
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FIGURE 4.1« MEMORY VS EXECUTION TIME 
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As seen in Figure 4» 1* execution of the programming task with 
less memory than indicated by the thrashing point yields 
inefficient execution times in region A* 

Beginning with the ?»0 version of the software* the HCP includes 
a programmatic facility for detecting a thrashing condition in 
the syste*. The facility is Included in GISttQ' as a discardable 
segment! it Is retained or discarded during the Clear/Start 

operation based upon the setting of a system option. It may be 
used with either victim selection algorithm* It must be t/sed if 
the priority victim select ion .algorithm is used. 

The facility is actuated by a clock laintained in the software. 
It utilizes a count of the number of overlay operations performed 
by the software* The count is also maintained in the software* 
of course* The sweeper routine discussed previously is actuated 
by the same clocfc that actuates the thrashing detection routine* 

At a user-selected interval* the thrashing detector compares the 
nuaber of overlays which occurred during the interval to 3 
user-specified target number of overlays* if the overlay target 
is exceeded* the thrashing detector suspends temporarily the 
execution of the sweeper routine and begins a count of the number 
of consecutive intervals during which the number of overlays 
exceeds the target number* The allowable number of intervals 
during which thrashing* as defined by the user* is detected is 
three* 

If the thrashing condition persists for three intervals* the 
software informs the operator via a SPQ message. The message 
will be repeated at H. SECOND intervals until the condition abates 
or until the operator requests* via another SPO message* that it 
not be displayed continually* The software also disables the 
schedule when thrashing is detected so that no new jobs are 
initiated* The schedule will be automatically enabled again when 
a program currently being executed terminates* 



U&J3SSI IMlUllZ&llM 



Weiory is initially allocated by the software during the 
Clear/Start operation. This single operation is composed of 
several components. For discussion purposes* it may be thought 
of as two separate operations* The first of the two is the 
execution of a stand-alone routine* commonly known as the 
Initializer and stored in the disk directory as 3YSTEH/INIT* The 
initializer is brought into memory by the Clear/Start code 
contained on the cassette* The second operation is the execution 
of some code in the MCP* contained in Page Zero* Segment One cf 
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the HCP's code file. 



At the couplet Ion of the initial §zer# memory will be foraatted as 
shown in Figure 4.2. Permanently allocated areas will be located 
at each %n6 of iseiory. Linked memory wilt consist of four links 
only. The processor is then passed to the HCP*s code segment for 
completion of the Clear/Start operation. Upon completion of tha 
MCP code* linked memory will be formatted as shown in Figure 4.5. 



BURROUGHS CORPORATION COMPANY CONFIDENTIAL 

COMPUTER SYSTEMS GROUP 31 OOO «CP II 

SANTA BARBARA PLANT P .5 . 2212 5462 IE) 

MAXIHUM ABDRESS 

I GlStfO DATA SPACE 1 
,.. ... ............ ..j 

I INTERRUPT QUEUE I 

I—— — — • ...... 1 

/ Sas Note 2 / 

/ / 

f . . — ....... ... ............ 

I FIRMWARE TRACE SPACE I 
I- .......... , 

I SISN8 CODE 1 

|. ....... .............. ......... f 

i MICRO HCP DATA SPACE J 

................ ..... f 

t HCP RUN STRUCTURE NUCLEUS I 

---....>|. ...«-..*. ........................ 1 

1 i JUTHLI See Note i 

I |..— 1 S0L INTERPRETER I— — I 

I I Hi i f 

I i ..j 

I 1 1 

Linked / / 

Memory / / 

t % m 1 i 

1 1 —.-—.——...... ......... 1 

I 1 MCP SEGMENT 0,1 | 
I J............J I 

I 1 LTHL I HL I i 

|..... >g. ....... ^.. ............... — 1 

I «CP SEGMENT 0,0 I 
I——— — — ——I 

I CHIP ERROR TABLE I 
f ....*...^. ......... ,..., 

f 'COLO/START VARIABLES I 
|..^.... .., 

I INTERPRETER DICTIONARY I 
I .... ........ ....... | 

1 &CF SEGMENT t PAGE DICTIONARY I 
t .--. .. .. .......! 

3 «CP STACKS I 

ADDRESS ZERO 

Figure 4»2 Memory Format After Initialization 
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1. "tiTHi" and "LTNL* are acronyms for upper and lower 
terminating ateasory links* These two Units Have a size field 
of iero and a type field which denotes a terminating fseisory 
tinfc* The upper link has a forward pointer of 3FFFFFF3I the 
lower tint; has a backward pointer of %FFF¥F¥2* The lints are 
used to mark the boundaries of tinted memory for the iteiuory 
allocation routines, fte&ory allocated by these routines will 
always lie between these two linfcs. 



e* during the initialization procedure* for the 




the latter case 
address in the systeau 
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I I UTML 1 

4-- — | SOL INTERPRETER §-- — -! 

I HL 1 I 

I .............. ....... -,.-| 

I PORT/CHANNEL TABLE* I 

I----J SPO VARIABLES AND BUFFER 1 

1 XL 1 1 

I --.—.-..-..-. -- f 

I IOAT* TAPE PAUSE ANO t 

I----1 TAPE LOCK DESCRIPTORS i 

i ML 1 I 

I ..... ............ -I 

* ADDITIONAL PORT/CHANNEL I 
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1 Ml I I 

f ...—. — . ...... ......... - f 

I QUEUE DISK TEMPLATE I 

I— — 1 1 

i HL 1 I 

I-. ........ ... — .- ..| 

1 MICRO MCP SEGMENT I 

J— -I DICTIONARY 1 

I ML I I 

j. ...... - — ... ........... | 

I SOL INTERPRETER SEGMENT I 

1----I DICTIONARY ! 

I ML I I 

I-.... .-., ...... .. 1 

i ERO AREA ! 

!-... |-- ; I 

i ML i 1 

j — ... ..... ... ...| 

1 1 

/ See Note 1 / 

/ / 

4 1 

FENCE LOCATION.! ] ~ -------------- -f 

J I 

j. -I I 

1 LTHL I 1 



Figure 4*3 Linfced Memory Format After Clear/Start 
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i. Though nothing is shown as present In figure 4.3 between tha 
SOL Interpreter Segment Oictionary and the Lower Terminating 
Hemory Link* this area Mitt typically be fitted with MCP code 
segments at the completion of the Clear/Start operation. 

2. The purpose of the fence shown in figure 4.3 was discussed 
previously. The location of the fence is retained in the HC? 
stacks. It is not necessary to reserve any memory at at* at 
the fence location. 



HZMM B£filiifi£fi£J*I£ 

The memory that wilt be required to execute a given program or 
set of programs is composed of four components. There are the 
static requirements of the operating system* the dynamic 
requirements of the operating system* the static requirements of 
the program and the dynamic requirements of the program. 

Static requir ements are composed of the data spaces necessary to 
operate the system and the program. Once the static requirements 
are established* they typically do not change* For example* once 
a program has all of its files open* the memory required for the 
File Information Stocks and the buffers remain fixed until the 
files are closed- In the case of the HCP* once the system is 
Clear/Started* the static requirements remain fixed until the 
system is Clear/Started again* 

Dynamic requirements are exclusively code segients. Assuming 
that a wording set of the code segments of a program is 
established* the dynamic requirements for that program will then 
be the total amount of memory that is required to contain the 
code segments that are a part of the working set. The operating 
system»s working set depends* of course* upon the communicate 
operators that ar& issued by the program in its own working set. 

QZIMIIM SI$I£H 5UI1Z fl&mfi£J»£flI2 

Those items shown in figures 4.2 and 4.3 comprise the static 
memory requirements of the operating system. Each item will now 
be discussed and a means of determining the amount of memory 
required by the item will be presented. The numerical values 

presented herein apply to the 9*0 version of the HCP only. 
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The stacks used by the HCP will always reside at location 
zero in S-memory. for each released version of the MCP* the 
stacks will be of a. fixed size* regardless of the machine 
configuration* The stacks require roughly 34*416 bits cr 
4302 bytes. 



RCP Page Dictionary and Segment Zero Dictionary 

These two items may never fee overlaid and are maintained in 
memory Immediately above the HCP stacks. They will also fee 
of a fixed size for each released version of the HCP, The 
10.0 version of the HCP code is divided into thirty-four 
segment pages and ?aqe Zero contains thirteen segments. Each 
entry consists of a system descriptor* which requires 80 bits 
or 10 bytes. For the 10. version of the HCP* this item 
requires 3760 bits or 470 bytes of memory. 

Interpreter Dictionary 

An Interpreter Dictionary entry requires 224 bits or 23 
bytes. The number of interpreters that may be used on a 
system at any given tine* and hence the number of entries 
allowed in the Interpreter Dictionary* may be specified by 
the user to be any value between 3 and 31. If the user does 
not specify this number* the Cold/Start routine will set this 
value to six. The memory required for the Interpreter 
Dictionary may be calculated by multiplying the number of 
interpreters allowed by the size of one entry. 

Cold/Start Variables 

The variables contained in this area are originally set by 
the Cold/Start routine. Many of the® maybe changed by the 
operator. The memory allocated for their storage may not be 

changed. It will also be a constant value for each version 
of the operating system. For the 10.0 version* the memory 
required is 2256 bit's or 282 bytes. 



Chip 'Error fable 

This area is allocated on 81B00 and 81900 series wachines 
only. On all other machines* no memory is required for this 
item. On the 81800 and 81900* the area is used to store the 
addresses of memory locations which are experiencing 
correctable memory parity errors* The size of the area in 
bits may be calculated by 40 plus C 32 times the number of 
entries allowed in the table)* The operator may specify tha 
number of entries the table should contain. The default 



k-\? 



BURROUGHS CORPORATION 
CQHPUTEH SYSTEMS GROUP 
SANTA BARBARA PLAMT 

value for the number of entries 
bytes of 5-memory on the system. 



COMPANY CONFIDENTIAL 

81000 nz? II 

P.S. 2212 5462 <E> 
will be one entry per 16* 



MCP Code in Page Zero* Segment Zero 

This code segment is nor Baity referred to as "Segment Zero" 
and the size of the segment is a constant for each released 
version of the HCP. This is the only HCP code segment which 
does not require a memory link* since it is outside of t inked 
memory. The code segment requires roughly 53*490 bits or 
6686 bytes of memory. 



Upper and Lower Terminating Memory Links 



In the iO.O verson 
187 bits of memory. 

bytes. 



of the software* a memory link requires 
These two then require 374 bits or 4/ 



SOL Interpreter 



The sixes of the SOL Interpreters presented here are for 

Accurate size figures and figures for the 

of the interpreters are provided in the 

pacification* Segment Zero of the 

of the SOL Interpreter requires 3166 



reference onty. 
various segments 
appropriate product 
S-Processor version 



bytes. The same segment of the 
8024 bytes* 



(•Processor version requires 



HCP Run Structure Nucleus 

The HCP requires a Hun Structure Nucleus field as does every 
other program which executes on the system. For the 9.0 
version of the software* 2386 bits or 298 bytes are allocated 
for this field. 

Hi era HCP Data Space 

Currently* 12 49 bits or 156 bytes are at located for this 
space. This requirement is a constant and is not dependent 
upon machine configuration nor system options selected* but a 
dual processor configuration will require two such spaces. 



GISMG Code 



GISHG is not segmented. Selected portions of the GISJ40 code 
are "discarded* by the Initialization routine if they are not 
required on a given system configuration with a given set of 
system options selected. The amount of memory that will be 
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must therefore always fee 



The Hain Block of GXSMO requires 5500 bytes of memory. Hq 

memory Unit Is required. The amounts of memory shown in the 
following table should be added if the condition specified is 
true, 



System equipped with Hemory 8a se 5 
Processor is a 81830 

is 81720 series 

is 81860 series 

is Dual. SldXX 

address check option set 

detection option set 
Prioriti?ed memory management option set 
TOUT option set 



Processor 
Processor 
Processor 

Reference 
Thrashing 



104 


byte s 


456 


bytes 


540 


'bytes 


642 


bytes 


1070 


bytes 


138 


bytes 


142 


bytes 


364 


bytes 


100 


b y t e s 



In the 
console 



list 

is not 



above* 



the 



cassette device on the processor 
considered a peripheral* Neither the cassette 
peripheral segment nor the magnetic tape or cassette segment 
should be added due to the console cassette* 



The control exchanges segaent should be Bdded when the system 
is equipped with two or more disk or tape controls and the 
controls address the saie peripheral units. High-speed 

controls are alt disk pack controls and any controls which 
address phase-encoded tape drives. Under no conditions is it 
necessary to add any GISMO code segment more than once. The 
Dual Processor segment and the 81860 segment must both be 
added if the system is a dual processor version. 



Firmware Trace Space 

Fbis area is allocated only when running with trace versions 
of the SOL Interpreter* It should never be allocated in a 



customer's machine. It requires 1*440 bits 



Interrupt Queue 

Since interrupts occur asynchronously on the 81000 system* 
they must be queued until they can be handled by the 
appropriate operating system routines. One entry in the 

interrupt queue requires thirty-six bits. Forty-two bits ar® 
required for pointers and counters. The number of entries 
which may be queued on a given system depends upon the amount 
of memory on the system* The number of entries that will ba 
allocated may be determined from the following table, 



S-Weaory on System 



Entri es 
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Less than 64K bytes 
At least 64K bytes but less 
At least 96K bytes but less 
128 K bytes or more 



than 96K bytes 
than 128K bytes 



16 
20 
25 
50 



The smallest amount of memory that wilt be allocated for ths 
interrupt queue is then C42 * 1 16 X 36) or 618 bits* Ths 
largest amount is 1122 bits* 



GISttQ Data Space 

The €ISMO data space is a work area required by GISHO. It 
a fixed size and amounts to 376 bits. 



OCPU DATA SPACE 

This is also a work area* It is required on all dual 

processor machines and requires 350 bits* 

Looking now at figure 4.3* the HCP* prior to completing the 
Clear/Start operation* will allocate space for those additional 
items shown on the figure* The location of the "fence" is not 
important to the discussion of the memory requirements of the 
HCP* The fence is merely a leans of guaranteeing that the HCP 
will always find space for its own purposes when such space is 
needed* The system would be forced to halt if the HCP could not 
find the space required. 

All of the items shown in figure 4*3 reside in linked teiory. 
One memory link C187 bits) is required to describe each of the 
items in figure 4*3 



Extended fie suit Descriptor Area 

One extended result descriptor* I/O descriptor and buffer is 
required for each 5H head"per-tr acfc disk control and for each 
disk pack spindle on the system* Each descriptor and its 
associated buffer requires 256 bits* This requirement 

applies to al* disk pack drives interfaced to the BIOGO 
system but not to cartridge drives. The memory required* in 
bits* may be calculated by 256 X {5H controls *• disk pack 
spindles) * memory link* 
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SOL Interpreter Segment Dictionary 

The segment dictionary of the SOL Interpreter is considered 
non-overlayable* since it contains a descriptor for segment 
zero of the interpreter which must be non-overt ayabie to 
execute segment zero of the HCP* The size of this arta* in 
bits* nay be calculated by 6* plus C80 ti flies the number of 
segments which comprise the interpreter > plus the space 
required for one savory tin*. The SOL Interpreter contains 6 
segments* plus Segaent Zero* 

Hiero HCP Segment Dictionary 

This segment dictionary is also considered non-overt ayabl e. 
Its size may be calculated in the same manner as the size of 
the SOL Interpreter segment dictionary* 6% 'plus C80 tines the 
number of segments) plus space for one memory link- The 

Micro HCP contains 18 segments* plus Segaent Zero- The 
segment dictionary therefore requires ifO bytes* 

Queue Disk Template 

The HCP reserves 500 segments of system disk for its own 
temporary use* The address of this reserved area of disk* 

known as Queue Disk* is stored in the memory area known as 
the Queue Disk Template. This memory area will also contain 
one bit to denote the availability of each of the 500 
segments* a 24-bit field which will be used to store the 
memory address of the next Queue Oisk Template if an 
additional 500 segments must be allocated and a 123-bit field 
known as the Communicate Splitter Mask* this latter field is 
used to determine which communicate operations may be handled 
by the Hicro HCP* The size of the initial Queue Disk 

Template field is therefore* 500+36+24*128 or 688 bits. 
Additional Queue Disk Template fields* if required* will 
occupy 560-bit areas. One memory link is required on each 
Queue Oisk Template allocated. 



Additional Port/Channel Tables 

The HCP and 5ISM0 communicate in a number of ways. One such 
way is the Port/Channel table. One Port/Channel table is 
allocated with the SP0 variables and buffer at the high end 
of linked memory. If the system is equipped with multi-line 
controls* an additional Port/Channel table will be required 
for each one. A Port/C^annBt table requires 7SQ bits of 

memory plus the space required for one memory link. 
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JGAT CI/O Assignment Table) 

Several items are grouped together In the space reserved for 
the IOAT. The IOAT itself requires one entry of 512 bits for 
each peripheral unit connected to the system with the 
exception of the SPO. Each disk: pack sp indie is considered a 
peripheral unit* Head- per -track disk is not* Data 

communications devices are not considered peripheral tnits 
for the purpose of calculating IOAT size* but eacn 

single-line control connected to the system requires ore IOAT 
entry. One "Pause" descriptor* requiring 96 bits of memory* 
is required for each tape control* cassette control and 
MTC-2/MTC-4 exchange on the system* One "Lock" descriptor* 
requiring 168 bits of memory* is required for each tape ani 
cassette unit connected to the system* One I/O descriptor of 
248 bits is required if any number of flexidisk units are 
connected to the system. One memory link is required to 
describe the ares containing these items. 

Port/Channel Table* SPO Variables and Suffer 

Information which the HCP needs to perform its function which 
is primarily concerned with the system SPO but also includes 
information on other aspects of the system is maintained in 
the area known as SPO Variables* This information requires 
1351 bits of memory. The Port/Channel table requires 768 
bits and the SPO buffer requires 560 bits* for a total of 
2679 bits* One memory link is required to describe the area* 
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The operating system 1 s dynamic memory requirements are determined 
solely by the size of the code segment which performs the 
functions requested by the user in the working set of his 
program* In determining this requirement* it is necessary to 
know what the program in question is doing* While programs could 
be and are written which have file open and close operations as a 
part of their working set- this is not normally the case. The 
vast majority of programs request only those functions which are 
micro-coded and included in the Hicro MCP in their working set 
code. This statement is not true for programs which use 0*5. 



This document will not present the memory requirements for 
programs which use DM5. This information will probably be added 
at some point in the future* but for the present* only the code 
segment sizes for operations believed to be common and exclusive 
of OKS operations will be presented. 
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The 41st below presents a brief description of the function and 
the memory requirement for each of the Micro HOP segments. 



SEGMENT* ZERO - 2506 8ytes 

Segment Zero of the Micro 
when programs are executing. 



MCP. is always required fr memory 



SERIAL - 1960 8ytes 

This code segment handles reads and writes on serial files 
that are opened input or output but not in any combination 
form* such as input-output* Also* some files assigned to 
data recorders may not require this segment. 

SEQUENTIAL - 762 '3ytes 

This code segment handles reads and writes on sequential disk 
files that are opened i nput"output • 

RANDOM - 944 Bytes 

This code segment handles reads* writes and seeks on code 
segments whose access mode is random. This code segment is 
required for alt random disk files* even if the access mode 
is delayed random. 

CGMP.WAIT - 1136 Bytes 

This code segment is required to handle complex wait 
communicate operations. AH data communications handlers 
generated by the HIOL compiler require the complex wait code 

to be present. 

OATA.RECOR - 144 Sytes 

This code segment is required to handle reads and writes on 
files which are assigned to data recorders and which are 
opened input-output or input with stacker selection 
capabilities requested. 



HI.PRI.ANO - 1292 Bytes 

This code segment is required to handle all communicate 
operations on files which are assigned to reader-sorters. 



k'lS 



BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 

SANTA BARBARA PLANT 



CGHPANY CONFIDENTIAL 

81000 WCP II 

P.S* 2212 5462 <E> 



CUEUE.READ - 856 Bytes 

This code segment handles read and write operations on 
queues* Please refer to the paragraph at the end of this 

list* 



PQM-GQH - 2SF4 Bytes 

(Put Queue *fessage.Get Queue Message). This code segment 

handles reads and writes on files assigned to queues and to 
remote files- Please refer to the paragraph at the end of 
this list. 

REHOTE.WRI - 2300 Bytes 

This code segment is required to handle writes or files 
assigned to remote files. Please refer to the paragraph at 
the end of this list* 



REMOTE. RE A - 2 89 Bytes 

This code segment handles reads on files assigned to reiota 

files. It is also required to handle many N0L/WACR3 

communicates. Please refer to the paragraph at the end of 

this list. 



DC.INITIAT - 410 8ytes 

This code segment handles the DC. INITIATE. IQ communicate 
operation* This communicate is issued by all data 

communications handlers generated by the NDL compiler. 



MESSAGE-CG - 206 3ytes 

This code segment is required to handle the message count 
communicate operator- also issued by all data communications 
handlers generated by the NOL compiler* 



VARIABLE. L - 412 Bytes 

This code segment handles read and write operations on 
and disk files which use variable-length records* 
required in addition to the SERIAL code segment- 
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EMULATOR.? - 508 3ytes 

This code segment is required to handle consunicate 
operations requested by any emulator Interpreter on files 
assigned to tape* 

DELAYED. RJ> - 592 Bytes 

This code segment* In addition to the random code segment* is 
required to handle reads* writes and seeks on files whose 
access type is delayed random* Emulator disk files are in 
this category* 

INBEXED.SE - 3020 Bytes 

This sequent is used for I/O operations on Indexed Sequential 

files* first Introduced in the 9.0 version of the software 

and described in the section of the document on the I/O 
Sub system. 

RELATIVE - 3638 Bytes 

This segment is used for 1/0 operations performed on Relative 
files* also described in the 1/0 Subsystem section. 

IPC. C0OE - 568 8ytes 

This segment is used to perform Inter-Process communication* 
a part of the ANSI *74 COBOL implementation first included in 
the 9*0 software. 



All code necessary to handle queues* remote files* tha 
DC. INITIATE. 10 communicate and the HESSAGE. COUNT communicate are 
included in the Micro-NCP. Microcoding these functions resulted 
in some substantial performance improvements for most data 
communications applications. There are several reasons for the 
improvement* the most obvious being the greater efficiency of the 
code. Another factor is that a minimal amount of state 

information must be saved when communicating with the Hicro-NCP. 



A third factor is the elimination of the ^bottleneclt* problem* as 
it has come to be called* for data communications applications. 
This problem arises from the fact that HCPII is a flat structure 
and is capable of performing one thing at a time only. In other 
words* once the MCP begins oerforming an open request for 
example* it can do nothing else until it completes the open. An 
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open* of course* requires many accesses to the disk subsystem and 
the MCP must wait on the ca&ptetion of each one. Normal-state 
programs are free to execute while the HCP is waiting on each 
access* provided they do not request an HCP service which fust be 
handied by MCPIX* 



Consequently* user 

the other items men 

request for other users* 

programs had to wait until the 



programs ©ay now use the queue subsystem a 
tioned above white nCPll is servicing anoth 



and 

er 

In previous releases* these safe user 

NCP completed servicing the 

Unfortunately* however* 



request it was working on at the time* Unfortunately* however* 
all requests for functions in the queue subsystem are not handled 
by the Hicro-NCP. Many of them* and possibly all of the** may 

~*JJJ Ka hanrfiari Hit MfPFI. 



stiit be handled by MCPI1. 



All memory management functions are still handled by SOL code in 
MCPII. Any queue request which involves memory management will 
therefore have to be handled by MCPII. This will most often 
occur in situations where the available memory on a system is 
limited- Queue buffers may be written to disk by rtCPII* and 
hence removed from memory* whenever the HCP needs space for 
something else. This will cause HCPII to be invoked when a 
program attempts to read a queue entry from that buffer. 

Further* if a producer of queue entries fills an entire buffer 
before the consumer can empty it* a new memory buffer hill be 
required. MCPII will be invoked to accomplish the allocation* 
Unfortunately* in both of these instances* the entire working set 
of Hicro-HCP queue handling segments will be brought into memory* 
only to determine that SOL HCP segments are ready required. This 
can result in substantial performance degradation* particularly 
on systems where available memory is limited. 

The situation described can be avoided* of course* by insuring 
that the consumer of queue entries removes them from the queue at 
the same rate that the producer enters them. Since it is only 
rarely possible for the programmer to insure that synchronization 
exists* a system option has also been provided in the 6.1 release 
which will insure that all queue requests are handled exclusively 
by the SDI MCP. By setting the option- the user may insure that 
performance does not degrade when going to the 6.1 release* as a 
result of the microcoded queue implementation* though he will 
receive no benefit from it at all* 



Six new segments were added to the Micro-HCP to accomodate the 
data communications facilities in the 6*1 release. The new 
segments are QUEUE. READ through MESSAGE .COUNT inclusively. 
Typically* data communication applications which use a handler 
program generated by the NQL compiler should consider all six 
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segments to be a part of their working set* though only the first 
four of the six are concerned with the queue i mplementat ion. The 
MESSAGE. COUNT segment is invoked by the communicate operator of 
the saie naiie and is used to determine whether or not a lessage 
exists in the queues* The DC IH IT I ATE* 10 segment is also invoiced 
by the communicate operator of the same name and should always be 
considered a part of the working set for any data communications 
appl teat ions* 

The static memory requirements of a program* that memory which is 
required for everything except the program's code* may be divided 
into two classes* Three items which are required are fixed in 
size and the user has no control over them. The user actually 
has little control over many of the static requirements* though 
there are some items which he may cause to vary. Items in tha 
tatter category are referred to as conditional requirements. 

The fixed requirements of the Program Static Memory are composed 
of three components. These are listed below* 



Run Structure Nucleus 

This is a table of information constructed by the MCP when 
the program reaches 8QJ. It is a fixed size of 2386 bits. 



Interpreter Segment Zero 

The size of Segment Zero* the non-overl ayabl e segment* of the 
Interpreter being used must be determined and added. Space 
for one memory link fust be included. 

Interpreter Segment Oictonary 

The number of segments in the Interpreter must be determined. 
The space required for its segment dictionary is then ten 
bytes times the number of segments plus space for one memory 
link. (10 X number of segments) + memory link. 

The following are the cardttional items which must be included in 
the calculation of Program Dependent Static Requirements. 

Program Code Segment Dictionary 

The number of code segments which comprise the program may be 
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determined from the compiler listing of the program. Code 
segment dictionary space in bytes is then determined by CIO X 
number of segments) * memory link. 
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Data Dictionary 

The number of data segments used by the program is known to 

the programmer and is available from the compiler listing- 

The space for the data dictionary in bytes is calculated by 

<10 X number of data segments). No memory link is reauired. 

Base -Limit Area Caiso known as Program Run Structure) 

This number is readily available from the compiler listing. 
It is the total data space required by the program (between 
Base and Limit Registers). Space for one memory link fust be 
added* 



File Dictionary 



There is one entry 
declared in the progra 
used or not. File Dictionary 
of files declared). No memory 



for each file 
it is ever 
space is given by 110 X number 
link is required. 



in the file dictionary 
p regardless of whether 



File Information Block CFI8 3 Space 

This may be calculated in bits toys 



1048 


X 


Number 


of 


796 


X 


Number 


of 


805 


X 


Number 


of 


7 96 


X 


Number 


of 


1048 


X 


Number 


of 


433 


X 


Number 


of 


1048 


X 


Number 


of 



MICH Files open plus 
Printer Files open plus 
Remote Files open plus 
Tape Files open plus 
Ois* Files open plus 
Queue Files open plus 
all other files open at 



the time. 



FI8 Hemory Links 

One memory link is required for each file that is open. 



Total Buffer Space 

The number of and the size of the buffer areas associated 
with each file that is open may be determined from a compiler 
listing. This size should be totaled and added. If the code 
file on disk has been modified* however* the size given on 
the listing may be incorrect. True buffer size nay be 
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determined through an HCP keyboard instruction 
81000 Software Operational Guide.) 



(Refer to 



I/O Descriptors 

There is one I/O descriptor* which requires 272 
space* for each buffer in each file that Is open. 



bits cf 



Di sfc File Headers 

Disk f!4e headers are maintained* either in memory or on 
disk* for all disk files that are open. If the fite is 

processed in a random access mode* the header is maintained 
in memory. Otherwise* the header is stored on di sir and 
brought into memory when new disk areas are allocated. Each 
header will require 580 bits plus 36 bits for each arsa 
requested by the file declaration* regardless of whether of 
not the area is allocated* plus space for one memory tink- 
This area is required only when the header is in memory. 

Header Dictionaries 

Qisfc file headers are addressed by the HCP through 
dictionaries. These dictionaries are segmented. One segment 
contains space for ten dictionary entries. Each dictionary 
entry is a system descriptor and requires 80 bits of memory. 
The space required for header dictionaries may be calculated 
by (800 + memory link) X ((disk files open HOD 10) * 1) bits. 
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To determine the working set of segments for any program one must 
know where a program spends its time or its '•main line* of 
procedure calls. The corresponding segment sizes must then be 
added up for this main sequence. Segment sizes can be obtained 
from compiler listings. For RPG programs* all code segments must 
be included in the working set. For all other programs the 
compilers produce a list of code segments and sizes. 
working set segments should be listed and totalled, 
sizes should have 20 bytes added to account for the 
associated memory link. 



Then the 

All segment 

size of an 



As previously discussed* if any interpreter segments are used by 
the program* these must also be included in the total. 
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The function of H~»emory management Is to best nsanage the 
available control memory CM-memory) in a dynamically changing 
envir onuent. There are four events which are able to affect the 
system's demand for H-metiory by the introduction or removal of 
interpreter s* 

aoj 

ECU 

ROLL IN 
ROLLOUT 

Upon the occurrence of any of these* if the interpreter set 
changes* the new deiands will be evaluated and M-aemory 

reallocated. 



One of two allocation scheaes will be employed: 



fll&IBIflUUJUi 



This method distributes the available M-memory statically auong 
the active interpreters* The size of each portion depends on tha 
interpreter's needs* and the available amount of H-aenory. Tha 
portion of the interpreter which is not able to be placed in 
H-meraory refrains in S-memory* As the number of active 

interpreters increases* this allocation scheme remains in effect 
until further dispersion of H-mamory would result in a severe 
performance degradation* irfhen this threshold is reached* the 

second allocation scheme is put into effect. 



£J2JtI£HXIflH 



This method dynamically shares H-mesory* in the form of n fixed 
size pages* among greater than n interpreters contending for 
these pages- When an in/erpreter succeeds in capturing a page of 
H-menory* the low-order portion of the interpreter will be copied 
into the page from 5-neraory* However* when the page is 

re-captured by another interpreter* since there is no aechani sm 
for transferring information from t4-uie<nory to S-roeaiory* the 
information in that page will be lost. Hence* all active 
interpreters must be entirely in S-aaefflory. 

DETAILED DESCRIPTION 
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1* When a new interpreter is to be brought into memory* the 
procedure "M.IN.H.OUT" is called. This may be called either 
from 8GJ* EOJ* ROLL. IN* or ROLL. GUT. The last entry in the 
interpreter dictionary is first stored in w 0IC.L AST.LQC". 
Then the interpreter dictionary is searched for entries 
whose usercount is equal to zero Cthus no longer in use). 
These entries are delated by catling "M.CLEARQUT*. 

The previous allocation method is then stored. If there is 
no M. MEMORY on the system €81710 series)* then the procedure 
"NO.M" is called. NG.N examines in turn* each entry in the 
interpreter dictionary to ascertain if it is in S. MEMORY or 
not* and If not* the procedure *0.TG.5" is called to bring 
in the interpreter from disk. The presence Pi t is then set 
(although the system has no M. MEMORY)* and a pseudo M. MEMORY 
address is calculated and stored in "lO.M.AOOft". NQ.M then 
exits to M. IN.M.QUT and thence to the procedure which called 
M. IN.M.QUT. 

Assuming that M. MEMORY does exist* the total minimus number 
of M. MEMORY pages required for all interpreters is added to 
that required for CSM* then this total number of pages is 
compared to the total number of pages of H. MEMORY available 
on the system. 

If the totat number of pages required is greater than those 
available* then the contention method is invoiced* otherwise 
the distribution method is invoked. The contention method 
witt be discussed first. for the distribution lethod* 
proceed to step 6. 



The contention method calls the procedure *CNTN. SETUP*. 
CNTN. SETUP first checks to see if the pages remaining after 
CSM is allocated is less than 2* and if so* then all the 
interpreters will be contending for the remaining page* 
including SOL* and the procedure contention is called 
(proceed to step 3). If the number of remaining pages after 
allocating CSM is not less than 2* then this number of pages 
is stored in W M. NUMBER. PAGES". The SOL interpreter is 
assigned a page* plus any fraction of a page which may be 
left over* This may occur if CSM does not occupy exactly a 
full page* normally 102% words. Next* the number of active 
interpreters is courted and this number comoared against 
H. NUMBER. PAGES. If H.NUHSER .PAGES is greater than or equal 
to the number of active interpreters* then the distribution 
method is called Cproceed to step 6). (This could be caused 
by an interpreter with a very large minimum requirement.) 



The procedure contention first ascertains if the SCL 
interpreter is partially resident In S. MEMORY* and either 
M. NUMBER. PAGES is equal to 1# or the portion of the SOL 
interpreter in M. MEMORY is greater than the size allocated 
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for SOL* if so* then the procedure *HIL*T0«S* is called* 
else proceed to step %. HIL.TQ.S saves the current 5. MEMORY 
address of the SOL interpreter* and stores the disk address 
of the SDL interpreter in the interpreter dictionary entry 
for SOL. The procedure "Q.TQ.S* is then called to bring in 
the interpreter from disk. O.TG*S looks for «eniory for the 
interpreter* flakes the found address mod. 16* reads the 
i n t er pr e t er i nt o me aior y and at ar k s the i n t er pr et er dictionary 
entry present. If sufficient wetaory space Has not found* 
then the previous €partial> SDL interpreter is restored in 
S. MEMORY* and all procedures exited* returning ail zeros to 
the procedure which called a.IN.M.QUT, Otherwise* the new 
copy CcoiBpiete) is marked not present in M.HEMOHY and the 
aieiory space of the old partial copy marked available. 
HIL.TO.S now exits* returning to the contention procedure 
Cproceed to step 5). 

4. If neither "M.NUHBER. PASES'* is equal to 1 nor the portion of 
the SOL interpreter in M» MEMORY is greater than that 
allocated for SOL* and if the portion of the SOL interpreter 
in H. MEMORY is less than that allowed* then the procedure 
"LK.OUT.MQR* is called to aiove more of the SOL interpreter 
from S. MEMORY to M. MEMORY. 

5. The procedure "H-CLEAROUT" is then called to clear out of 
the interpreter dictionary alt partially resident 
interpreters* with the exception of SOL. Each entry in the 
interpreter dictionary is then in turn examined* and passed 
through the procedure W CNT?^.LOA0R ,, until all entries are 
examined* at which titne contention is exited to H.IN.H.0UT 
Cproceed to step 10). 

The function of the procedure "CNTN.LOADR* is to load 
interpreters either from disk to S*H£W0RY* and/or fro* 
S. MEMORY to M. MEMORY. It first examines the interpreter 
dictionary entry to determine whether the interpreter is on 
disk or in S.HEHORY. If it is not in 5. MEMORY* then the 
procedure "O.TO^S* is called to bring the interpreter in 
frora disk. If sufficient fneniory space is not found* then 
D.TO.S exits through all procedures* returning all zeros to 
the procedure which called M.IN.N.OUT. "IQ.M.A00R- and 

"ID.TOPN" are calculated. Each interpreter is set up for 
one page of memory. If there is available M. MEMORY left* 
then the page is overlayed from S.MEMORY to *. MEMORY 
(proceed to step 10). 

6. If the total number of pages required is not greater than 
those available* then the di str ibuti on method is invoked* 
and the procedure "REDISTRIBUTION* called. The procedure 
redistribution calculates whether the amount of available 
M. MEMORY is exactly of a si^e required to house the ainimun 
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requirements of ail interpreters and GSM. If 
procedure "M.GRXNOCft" is called passing a 
(Proceed to step 7). 



so* then 
value of 



the 
1. 



Otherwise* the total amount of memory required to house the 
maximum requirements of alt interpreters and CSM is 
calculated and compared against the total amount of M. MEMORY 
available* and if less than or equal to the amount of 
M. MEMORY available* then the procedure M. GRINDER is called* 
passing a value (field WHICH ) of ler® (proceed to step 7). 

If neither of the above conditions is let (that is* neither 
the mini mum nor the maximum of all interpreters will fit in 
M. MEMORY) then the procedure "DISTRIBUTE" is called* passing 
a value (field HUH) of zero* The procedure distribute 
stores the maximum available M. MEMORY* amount required for 
CSH* then if HUH = 0* it initially assigns each interpreter 
its minimum required space* increments each one in turn by 
one page* until all available M.MEMORY is allocated. If HUH 
= I* each interpreter's minimum is assumed to be zero* then 
incremented by one page until alt available M. MEMORY is 
allocated. The procedure M. GRINDER is then called* passing 
a value (field WHICH! of 2. 



7, 



The main function of (UGRXNOER is to reallocate M. MEMORY one 
of three different ways* depending on the values of '•WHICH*. 
M. GRINDER examines each interpreter dictionary entry in 
turn. After having examined all interpreters* if there is 
still some M. MEMORY remaining* then proceed to step 9# 
otherwise proceed tn step 10. 

If the entry being examined is not in M. MEMORY* or the page 
being examined is not the current H. MEMORY page* then 
proceed tp step 9. Otherwise* if the size of this page in 
M. MEMORY is not the size it should be* proceed to step a. 



If this M. MEMORY page is the correct size? and if the 
interpreter is either partially resident in 5. MEMORY or if 
the total length of the Interpreter is less than or ecual to 
the amount of this interpreter currently in M. MEMORY (i.e.* 
the interpreter is entirely in M. MEMORY); and this 
interpreter is not in S. MEMORY* then proceed to step 9. 

Otherwise (that is* the interpreter is entirely resident in 
S, MEMORY* so the portion of S. MEMORY which was copied to 
M. MEMORY must be returned)* the interpreter is marked as 
partially resident in S. MEMORY. If the total length of the 
interpreter is less than or equal to the amount of the 
interpreter currently in M. MEMORY* then the procedure 
"ALL.XN.M" is called to return the entire S. MEMORY space for 
this interpreter. Otherwise* the procedure "LK.OUT. *E«" is 
called to return the S. MEMORY space corresponding to that 
portion of the interpreter which has been copied into 
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a. If the amount of the interpreter In M. MEMORY is less than 

the amount allocated in ft. MEMORY for this interpreter* then 

the procedure w LK»0UT.M0R w is called to copy mors of the 
interpreter from S. MEMORY to M. MEMORY. 

9. If this point is reached* then the appropriate interpreter 
must be brought in from disk. 

The procedure "M.CLEAROtir* is called to ctear out all 

partial interpreters from the interpreter dictionary (with 

the exception of the SOL interpreter and already fitted 
interpreter s). 

If the current entry in the interpreter dictionary is SOL* 
then the procedure HIL.TO.S is called (refer to step 3 for 
the functions of HIL.T0,5)« If sufficient memory space is 
not found in HIL.TO.S* than exit through alt procedures 
passing a value of all zeros to the procedure which called 
M.IN.H.QUT. Next* each entry in the interpreter dictionary 
is examined in turn* ar\4 if present in S. MEMORY but not in 
M. MEMORY* then the procedure *S.T0.M* is called to overlay 
the appropriate page from 5 .MEMORY to M- MEMORY* and to 
return either the entire S. MEMORY space occupied by the 
interpreter or else to return only the portion overlaid. 
Each entry in the interpreter dictionary is once again 
examined in turn* and if the presence bit is set* proceed to 
step 10* 

If the presence bit is not set* then the procedure O.TG.S is 
called to bring in the interpreter from disk to memory 
(refer to step 3 for a description of O.TO.S). If 

sufficient memory is not found in O.fO.S* then all 
procedures are exited* passing a value of all zeros to the 
procedure which called M«IN«M*0UT* 

The procedure S.T0.& is then called Isee description above). 



10. At this point* the allocation method (either distribution or 
contention) has been decided and executed* and control 
passed back to N*IN*M«G0T« 

If the new allocation method chosen was successful* and if 
the new allocation method is the same as the old one* 
proceed to step 11. If the new method is distribution 

(therefore* the old was contention)* then the procedure 
RELEASE. A. 5£G is called to mark the MCP segment REIN. STATE 
available (reset save bit in the memory link). If the new 
method is contention* then the procedure SAVE.A.SEG is 
called to mark the MCP segment REIN. STATE saved (set save 
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11. If the value passes to H. GRINDER CWHICH) was or 1. Then 
return from W.68INQER through redi stribytf on> to M.IhUH.OUT. 
If the value passed to M. GRINDER (WHICH} was Z* then return 
fron M.GRINOER through DISTRIBUTE to REDISTRIBUTION, to 
H*Ilj«N«OUT and thence to the procedure which called 
fUXtt.M.OUT. 
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Viewing the HCP as a manager of processes emphasizes its role in 
the management of Job execution. That part of the MCP concerned 
with such management may be termed the "process controller*. 
While the process controller is not a distinct nodule in the HCP* 
it is a convenient terra to describe all those distinct functions 
which* taken together* fori a conceptual package* Certain of 
these functions* namely "RQLLI^"* -ROLLOUT"* "CAUSE-* "HANG 
PROGRAM"* are best understood within this context and bill be 
discussed in depth in this section. 

The actual execution of programs* the allocation of processor 
time to processes which are ready to execute and are* therefore* 
in the Ready Queue* is accomplished by micro code contained in 
GISMO irnown as the "Micro Scheduler". The Micro Scheduler is a 
part of the process controller. The Micro Scheduler is 

responsible for the allocation of alt processor time en all 
processors which way be attached to the system. 



The process controller is driven by the occurrence of certain 
software events* called "soft events"* which can be identified 
and anticipated by the MCP. When a process subaits a request to 
the HCP* the process nay or lay not be required to wait. If a 
wait is necessary* the HCP is able to anticipate the event upon 
which that process must wait. Thus the MCP can label the Job as 
waiting for soae "soft event"* suspend the Job by placing it in 
the "wait queue"* and continue to execute its other duties. When 
the soft event "happens"* the Micro MCP can search the wait queue 
to discover the process marked waiting for the happening of that 
event. 



The "HANG PROGRAM" function* which places programs in the wait 
queue* and the "CAUSE" function* which takes programs from the 
wait queue* are crucial. Both functions must be cognizant of the 
same soft events. "HANG PROGRAM" is responsible for creating a 
unique bit string which will represent the soft event for a 
process. On the other end "CAUSE" must have the proper soft 

event generated for it* so that the waiting process can be 
located. 



The main asset of this method of process manipulation is to free 
the MCP Iron waiting for the coipletion of I/O operations. It is 
able to initiate a requested operation and to independently match 
a soft event with its corresponding process at a future tite when 
the operation has iseen completed* 
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The process controller receives inputs from two sources: an "I/O 
DEVICE- or a "CONTROL DEVICE". Both may affect processes in the 
system. User demands upon the system are submitted through a 
control device which may accept only control language statements. 
On the 81000* the supervisory printer CSPG3 may only be used as a 
control device. The card reader may be dynamically assigned as a 
control device or an I/O device. Alt other peripheral devices 
may be used as I/O devices only. In addition* a program may act 
as a control device by sending a communicate to the HCP which 
contains a control language statement. See "PROGRAM 
COMMUNICATES". 



Control language statements* of direct interest to the process 
controller* may be divided into three categories: 

CD Statements which generate a soft event Ce.g.* allow a 
suspended process become active* direct a process to a 
peripheral device } 

(2J Statements which cause fob suspension 

11} Statements which request Job execution and provide all the 
appropriate parameters 

If the control language statement requested that a Job be 
executed* the '"Control Language Processor * directs that the job 
be scheduled. Briefly* the scheduling function involves placing 
it in the "schedule queue* Put allocating no machine resources. 
In the HCP outer loop* the schedule queue is periodically 
checked* and the first lob in the queue is initialized. 

•Program Initialization* involves allocating the machine 
resources and setting up the structures necessary for program 
execution. Once the job has been initialized* it is placed in 
the "READY QUEUE" to await actual execution. 

Once a program has been initialized* it will move in and out of 
six possible states during the course of its life in the system: 

READY QUEUE 

COMMUNICATE QUEUE 

WAIT QUEUE 

UQT QUEUED* EXECUTING 

WOT QUEUED* COMMUNICATE BEING ANALYZED 

M COMMUNICATE QUEUE 
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The ready queue contains jobs which are ready to run- The 

communicate queue contains Jobs which have requested sone MCP 

function- The wait queue contains jobs which are waiting for the 
happening of a "soft event*. 

The queuing mechanism is managed as follows* Ait run structures 
are linked in memory by priority. A field in the run structure 
nucleus* *R5.Q.IQENT W * specifies the current state of the 
process* The first member of a queue can thus be found by 
searching the linked list of ran structures until the proper 
value in RS.S.IGENT is found. 

A job waiting in the ready queue represents a demand for 
processor time upon the system. This queue is interrogated by 
the Micro Scheduler. If a job is found* the reinstate function* 
which is performed by the Hicro Scheduler in 6ISNQ* is called in 
preparation for turning the processor over to that fob. Briefly* 
the reinstate function performs certain housekeeping duties and 
causes a processor to begin execution of that job. 

The program will execute until one of three things happens 

CI) The program* s interpreter discovers an interrupt which 
requires the NCP*s attention. 

(2 3 The program needs some HCP service performed before it can 
continue 

13) The master processor instructs the slave to idle. 

In any case a communicate message is built in a field called 
fiS.COHMUNICATE.MSG.PTH in the program's Hun Structure Nucleus and 
control is passed back to the Hicro Scheduler. 

The contents of RS.CQHNUNICATE.NSG.PT8* analyzed by the 

"communicate handler** in the Hicro Scheduler* specifies what 
action is to be taken upon the program. In the case of 11) 

above* the message will simply contain a request to be put back 
in the ready queue. CThe Hicro Scheduler then returns to its 
outer loop where it independently discovers the INTERRUPT.) 

A request for service C2) may or may not require that the program 
wait for the happening of some soft event. If the request can 
immediately be serviced* the Hicro Scheduler does so and places 
the Job back in the ready queue. If the program must wait* 
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however* the "HANG PRGG8AM" function is called. 



"HANG PROGRAM* puts the job in the wait queue and labels it as 
waiting on the appropriate soft event. Depending on the reason 
for the wait* the program may or may not be "rolled out". The 
"ROLLOUT* function wilt copy all but a central core 
program's Run Structure Nucleus to disk. For a 

discussion of these functions* see their respective 
below. 



of the 
detailed 
sections 



The program will remain in the wait queue until the event upon 
which it was waiting has bean "caused". The soft event up<}t% 

which a job must wait may coie from three basic sources: 



<1) I/O interrupts 



C2> Control language statements 



o) ncp 



I/O interrupts are "hard events" which must be transformed into 
soft events before they may be associated with a process. A hard 
event is any asynchronous occurrence in the hardware of which the 
software must be cognizant. The occurence of such a hard event 
is usually manifested by a flag in the processor. The function 
of "I/O COMPLETE" is to transform those hard events of interest 
to a process into its corresponding soft event. 

Some control language statements wilt cause the control language 
processor to generate soft events. Such statements signify the 
happening of some event a process might be waiting for Ce.g.» 
"AX"# W IL"* "UL"# "G0 W * and "OK"). 



Other soft events are generated internally by the NCP. For 
example* processes waiting on a no-memory condition or a parent 
pro gran waiting for the termination of a nested program mtst be 
notified when they are able to resume processing. The MCP 
generates such soft events. 



At the point when the soft event has been generated {from 
whatever source)* one can say that the "event has happened". 
This soft event is used by the Micro Scheduler function to locate 
the corresponding process in the wait queue. 
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If the process is in memory Chad not been rotted out)# the Hicro 
Scheduler analyzes the reason that the process had been waiting 
to deter ml ne whether or not the last communicate was cotpleted. 
If it was* the fob is put in the ready queue to await 
reinstatement. If the communicate was not completed* the Job is 
put in the conmunka te queue to wait for the reinitiation of the 
communicate by the communicate handler. 

If the process was not in memory and memory is available* then 
the "ROLLING function is called. Its duty is to re-establ ish the 
run structure that had been "rolled out" to disfc. The reason for 
waiting is then analyzed in the same manner described above. If 
there was no memory available for roll-in* then the |ob is put 
back in the wait queue to wait for memory. The wait reason will 
be updated to reflect this status change and to specify into 
which queue the Job would have gone had memory been available. 
When memory becomes available* the Job will be put directly into 
the specified queue. 

The process will continue to be manipulated in this fashion until 
it has completed execution. At that time it will request the 
end-of-job function from the MCP and terminate. 
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The MCP can be viewed as a program whose sole duty is to respond 
to demands made upon ft by the system* This seemingly innocuous 
statement is valid even though the NCP is a vastly complex 
program. The complexity arises* however* by virtue of the 

diversity of demands to which the MCP is able to respond. 

There are five basic categories of demands to which the MCP 
initially responds* These categories are recognized at the 

outermost or most global level of the MCP* which iteratively 
searches for each. Once a demand is found* it is analyzed at 
increasing levels of detail and resolved according to its 
specific request. Control is then returned to the outer loop 

which continues to search for demands. 

The five types of demands recognized by the HCP*s outer loop are 
described below* 



Iilf£fi IH1EMUU 



The first type of demand recognized by the MCP is called a timer 
interrupt. There are two fields in the MCP»s global data space? 
A software maintained system clock and a clock mask. Every tenth 
of a second an interrupt is caused by the hardware. GISMO 

detects this interrupt and bumps the system clack. Every tiie 
the MCP begins its loop searching for demands* it checks to see 
if the value of the system clock has exceeded the value of the 
clock mask. If it has* the MCP calls the "N. SECOND" routine to 
perform its housekeeping duties and resets the clock mask to some 
value greater than the system clock. See "M.SECGWO routine". 



uq usig&mm 



An I/O irterrupt is a soft mechanism by which GISMO notifies the 
HCP that an I/O operation is complete. GISMO will only do so 
when the MCP requests that it be notified or when an exception 
condition has occurred on the I/O operation. This should not be 
confused with a "service request** type of interrupt. This 
service request is a hard level in the processor and is used to 
notify the software that a hardware I/O control is in need of 
service. 
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The HCP will request notification of the 
comptetion only when there is a need for it to 
does not request the return of I/O complete 
I/O operations unless the program which caused 
be initiated is waiting on the I/O operation, 
further in the sections of the specification 
WRITE. 



occurrence of I/O 

know. The HCP 

interrupts on user 

the operation to 

This is discussed 

covering READ and 



Hhen an I/Q operation is completed* GISHO stores the result 
descriptor associated with the operation in its proper location 
in memory. The field is known as the "result descriptor field" 
and is a part of the actual I/O descriptor. There is an area 
allocated in memory fcnown as the interrupt stack* which is 
actually a queue of I/O complete interrupts. GISHO* after 
storing the result descriptor* if the interrupt request bit in 
the descriptor was on* stores the address of the result 
descriptor in the interrupt stack and "causes** the HCP* if it is 
waiting. In its outer loop* the HCP requests that GISHO deliver 
the address on the top of the interrupt stack. It analyzes the 
descriptor at that address and takes the appropriate action. The 
HCP continues to request addresses from GISHO in this fashion 
until the stack has been exhausted. 



Upon receiving a descriptor *s address from GISHO* the HCP invokes 
a routine called "IQ.CGHPLETE" to begin the analysis. Depending 
on the value found in a field of the result descriptor* 
10. COMPLETE invokes one of the following HCP facilities* each of 
which is discussed in depth* on the following pages. 



CAUSE HECHANISH CSEE -PROCESS HANAGEHENT") 
CONTROL LANGUAGE PR0CES50I* 
I0AT HAINTENANCE 
I/O ERROR HANDLER 
SPO MAINTENANCE 



illS KMtmiilS &M IMIULllAIlM 



After exhausting the interrupt stack* and if an HCP global* 
"CHANGE. 8IT"* is true* the HCP checks the "schedule queue" to 
determine if any Jobs have been scheduled for execution. 
CHANGE. BIT will be false whenever a previous attempt at program 
initialization failed because of insufficient memory* and nothing 
has intervened to create a possibility of success at this 
attempt. The program initialization routine sets CHANGE. BIT to 
zero (false) whenever an initialization fails. It is set to one 
(true) whenever a block of memory is freed by fob termination or 
"rollout"* whenever a new job is placed at the top of the active 
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schedule* or whenever explicitly set by the "PS" control language 
statement* The HCP is thus able to maximize its own resources 
by-passing a futile attempt at Job initialization. 
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The HCP selects the first |ob in the active schedule for 
initialization, once the job has been de-queued* control is 
passed to the "program initializer** which allocates the machine 
resources and sets up the structures necessary for the program's 
execution* 



£UMMIQ&1£$ 



A program may request certain services from the MCP. These 
requests represent another class of demands to which the HCP Bust 
respond. The "communicate queue* contains fobs which have 

submitted such a request. 



The queuing mechanism is managed as follows* -____ 
nucA. au s c niUains two fields: "RS,eOHMUNICAT£,MSG.PTR 



Each run structure 



standard meTsage area and *Rl»_9^0ENX^__whi ch specifies™" in which 
queue* if any* the program is. The value of RS.a,IO£NT may be: 



= REAQf QUEUE 

1 = COMMUNICATE QOEUE 
11 * WAIT QUEUE 

-2 = NOT QUEUED Ci.e,* running) 
10 = H&CP COMMUNICATE QUEUE 
3 = EXTERMINATE QUEUE 



All run structures are linked together bf priority. Thus the 
members of a given mieue may be discovered by searching the 
linked list of run structures and checking RS,C,ID£NT. 
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The first job in the communicate queue Is serviced according to 
the contents of RS. COMMUNICATE. MSG .PTR. The message is initially 
analyzed by the communicate message handling routine which calls 
the proper subroutine to further analyze the message and take the 
appropriate action* The proper subroutine is determined by the 
first two bits of this message area catted "RS.ITYPE*. The 
values and corresponding meanings of this field are as follows* 



00 = INTERPRETER GENERATED COMMUNICATES 

01 = PROGRAM GENERATED COMMUNICATES 
10 = UNDEFINED 

il = FILE CLEANUP COMMUNICATE 



Interpreter generated communicates contain requests from the 
program's interpreter for services which are unrelated to the 
program's code. These include requests for missing segments,. 

trace and run tine error Massages* etc. 



Program generated communicates are requests 
services such as I/O operations. These 

"PROGRAM COMMUNICATES*. 



for code related 
are specified under 



The file cleanup communicate is an MCP generated communicate used 
in conf unction with program end-of-job* 



£B&£BJH B£I1!2I4I£ 



To be specified. 
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Alt object programs communicate with the MCP by means of a 
Communicate S-operator, The operator serves to transfer control 
from the user f s interpreter to the MCP f s. Though many 

communicates are now handled by micro-code in the Micro-MCP* the 
means of communication has not changed. The compiler generates 
code which establishes an ansa in the prograit»s run structure. 
This area generally conforms to a standard format which is 
recognizable by the MCP. The fields in this area are de*! n «d 
arbitrarily* however. Only the first twelve bits of the field 
must conform to the format presented below. 
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VERB 





m 


11 


OBJECT 


12 


m 


35 


ADVERB 


36 


- 


47 


CT.l 


48 


'Ml 


71 


CT.2 


72 


- 


95 


CT.3 


96 


- 


119 


CT.4 


120 


- 


143 


CI. 5 


144 


- 


167 


CT.6 


168 


■urn 


191 


cr.7 


192 


- 


215 


CT.8 


216 


• 


239 


CT.9 


240 


- 


263 


CT.10 


264 


- 


297 


CT.ll 


2 98 


■» 


321 


CI. 12 


322 


- 


345 


CT.13 


146 


- 


369 


CT.14 


3 70 


- 


393 


CT.15 


594 


- 


417 



Notes All couiunicates return a value of 30000000000005 or 
30000180000009 in the R5 .REIN3I A T£ .HSG.PTR unless 
otherwise specified* 



All interpreters* when executing the Communicate 5-operator* 
store a pointer to the reserved* formatted memory area in the 
field called RS.C0HHUN1C ATE.N5G.PTR of the RS. NUCLEUS of the 
program being executed. This forty-eight bit field specifies not 
only the relative address of the communicate area* out also the 
size of the area in bits. For further information on this aspect 
of the operation* refer to the programmatic description of 
Run Structure Nucleus. 



the 



If the HCP needs to convey information back to the object program 
after executing the requested communicate* it does so by setting 
the field catted «S.«EINSr ATE.NSG.PTR to a selected value. If no 
information is to be conveyed* this field is set to either 
aooOOOOOOOOa or 30000180000003 before reinstating the program. 
Other values* and tneir associated meanings depend upon the ty^e 
of communicate being executed* and are described for each 
cbmmunicate in the sections which follow. 
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CT.VER8 



00 

ILLEGAL 



COMMUNICATE 



8£AD IM££J2 £££1 



CT.VER8 


01 






CT. OBJECT 


FILE, 


.NUMBER 




CT. ADVERB 


SIT 











REPORT 


I 




1 


REPORT 


i 




z 


REPORT 


I 




3 


LENGTH 


A 



RETURN TO USER ON EOF 

RETURN TO USER ON PARITY 

RETURN TO USER ON INCOMPLETE I/O 

AOORESS PAIR IS PRESENT FOR RESULT 



MASK FIELO 



STACKERS— STACKER # IS IN CT.3 



CT.l 
CT.2 
CT.3 



CT.4 

CT.5 

CT.6 

REINSTATE. MSG 

1 
2 
3 
4 



4-6 
1 

3-11 - 

LOGICAL RECORD SIT LENGTH 

LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
RANDOfl FILE ACTUAL BINARY DISK KEY 
CRECORO NUMBER INSERTED 8Y «CP FOR SERIAL 
OR 

LENGTH OF KEY FOR REMOTE FILES 
AOORESS OF KEY FOR REMOTE FILES 
LENGTH IN BITS OF RESULT MASK 
BASE RELATIVE ADDRESS OF RESULT 
PTR VALUES 

GOOD READ 

END OF FILE 

I/O ERROR 

INCOMPLETE I/O 

IMPOSSIBLE SEARCH CRP6 SEARCH dP} 



FILES) 



ONLY 



MASK FIELO 



A READ communicate on 

logical record to the 

record from the I/O 

previously stored fey 

(Base/Limit) area* tn 

communicates are performed by the Hicro-MCP. 

since the 5.1 release of the software* 



the 31000 Systea serves to deliver a 
user program. It does this by moving the 
buffer area in memory* where it was 
the CSH* to the user's Run Structure 
almost all cases* the READ* WRITE and SEEK 

This has been true 



The information passed in the communicate area must include a 
unique file number. This number is assigned by the compilers and 
is passed to the MCP in CT. OBJECT. The sale statement is true 
for all communicates which deal with an I/O operation* such 3s 
HRITE, SEEK, OPEN* CLOSE* POSITION and so forth. 



The communicat e information must also contain the base-r elat i ve 
address of the memory area where the record is to be stored and 
the length* in bits* of this area. These iteis are passed in 
CT ,2 and CT-1» respectively. 



the user program to wait unt4i a requested I/O completes* If* 

for example* the program is reading cards and the card reader is 
not ready* it may be a long ti»e until the operation completes. 
For such programs* the third bit In CT.A0VER8 Is used* Setting 
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this bit causes the MCP to return control to the user program* 
regardless of whether a record was delivered or not. If no 
record was delivered* the program is informed of the situation by 
setting proper values in R5. REINSTATE. M56.PTR. This is discussed 
in wore detail later in this section. 

Remote files may consist of more than one data communi cations 

terminal* In such a case* it is necessary for the cofect program 

to specify the identification of the terminal it wishes to read 

from* This is accomplished by setting CT.3 and CT.A to the 
proper values. 

In all three of the cases described previously* where bits one* 
two or three are set in CT.ADVER9* it is necessary for the HCP to 
inform the user program of the existing condition. This is 

aecotrpl i shed by setting a field in the RS. NUCLEUS to a specific 
value prior to reinstating the program. The field is defined as 
RE .REIN5TATE.M5G.PTR and is accessed by the user's interpreter as 
soon as it is reinstated* after doing a communicate. If a valid 
record was delivered to the user* the message field is set to a 
value of zero. It wilt be set to one* two or three if the 
respective bits are on in CT.A0VER8 an4 the condition assigned to 
these foi ts exi sts. 



If a user program READ communicate encounters an end-of-fils 
condition and bit one in CT.AGVER8 is not set* the program will 
be discontinued by the MCP. If a user I/O operation results in 
an irrecoverable error and bit two is not set in the REAfl 
communicate which requests the record* the program will be 
discontinued by the MCP. If a user program requests the data 
from an I/O operation which is not } yet complete and bit three of 
the adverb is not set* the program is merely forced to wait for 
the I/O completion. 

For files which are assigned to Data Recorders and other selected 
card Input/Output devices* the user may specify that the card 
which was read is to be routed to a certain physical stacker on 
the device. This is accomplished by setting the specified bit in 
CT . ADtfERB to one and by setting CT.3 to the binary number which 
designates the physical stacker. In this case* there is never a 
need for more than one buffer area to be assigned to the file* 
and the MCP OPEN routine will prevent this from hapoening. Card 
I/O operations in this case are not "buffered** and card 
throughput will decrease accordingly. 

For random disk files* a READ communicate may not result in an 
I/O operation being initiated. If the user who does the READ is 
the sole user of the file and if the block which contains the 
requested record is already in memory in one of the user f s buffer 
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areas* the requested record will be siiply moved to his work 
area* This action is not performed ii there is more than one 
user of the file* 



miii isiicBfl acfj 



CT-VER8 
CT. OBJECT 
CT.ADVERS 



CT.i 

CT,2 
CT,1 



CT.4 

CT.5 
CT.6 



02 

FILE 

BIT 



1 

2 

3 

4-5 

6 

7 

8-11 



.NUMBER 

REPORT 
REPORT 
REPORT 
LENGTH 



4 RETURN TO USER ON EOF 

I RETURN TO USER ON PARITY 

I RETURN TO USER ON INCOMPLETE I/O 

ADDRESS PAIR IS PRESENT FOR RESULT 



MASK FIELD 



QUEUE FILES* WRITE TO FRONT OF 
QUEUE ("STACK"}* 
STACKERS — STACKER # IS IN CT*3 
PRINTER SPACING (4 BIT VALUE) 

NO PAPER ADVANCE 

1 SKIP TO CHANNEL 1 AFTER PRINTING 

2 SKIP TO CHANNEL 2 AFTER PRINTING 
5 SKIP TO CHANNEL 3 AFTER PRINTING 

4 SKIP TO CHANNEL 4 AFTER PRINTING 

5 SKIP TO CHANNEL 5 AFTER PRINTING 

6 SKIP TO CHANNEL 6 AFTER PRINTING 

7 SKIP TO CHANNEL 7 AFTER PRINTING 

8 SKIP TO CHANNEL 8 AFTER PRINTING 

9 SKIP TO CHANNEL 9 AFTER PRINTING 
A SKIP TO CHANNEL 10 AFTER PRINTING 
8 SKIP TO CHANNEL 11 AFTER PRINTING 

SKIP TO CHANNEL 12 AFTER PRINTING 

TO TOP OF FORM C 1500 LPM PRINTER 



SKIP 

SINGLE SPACE AFTER PRINTING 
DOUBLE SPACE AFTER PRINTING 
LOGICAL RECORD BIT LENGTH 

LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
RANDOM FILE ACTUAL BINARY DISK KEY 
(RECORD NUMBER INSERTED BY MCP FGR SER?AL 
OR 

LENGTH OF KEY FOR REMOTE FILES 
ADDRESS OF KEY FOR REMOTE FILES ONLY 
LENGTH IN BITS OF RESULT MASK 
BASE RELATIVE ADDRESS OF RESULT MASK FIELD 



ONLY) 



FILES) 



REINSTATE. MSG.PTR VALUES 

GOOD WRITE 

1 ENO OF FILE 

2 I/O ERROR 

3 INCOMPLETE I/O 



A WRITE communicate on the 81000 system operates In a manner 
similar to READ* The user program constructs a logical record 
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somewhere within its Sun Structure and communicates with the HCP. 
The HCP wilt then move the data from the work area* the address 
and length of which are described by CT.2 and CT»1 respectively* 
to the next available I/O buffer area. The program will ba 

allowed to continue as soon as the movement of the data occurs! 
it is not forced to wait for completion of the actual I/O 
©per at ion. 

As in the case of the READ communicate* either clank-fill or 
truncation of the record wilt occur* depending upon the sizes of 
the wort area and the fite*s logical record* The buffer frill be 
released* which aeans that the corresponding I/O operation will 
be initiated* as soon as the buffer area has been filled to 
capacity. A program is forced to wait for I/O completion if the 
MCP cannot find an available buffer to which it can wove the 
record. A buffer is unavailable if the previous I/O operation* 
which may have been initiated some time ago* is not yet cotplete. 

End-of-file is not reported to a user on an output file except in 
the cases of disfc files and soaie printer files* £nd-of-file for 
a disk file is defined to be an attempt by the user to write past 
the declared size of the file. The,„dja£l_a red siie of all disk 
files is j a intained in t he file iieajd an* a . _p.e r f a ne n t entity 
created when the file is opened output for the first tiiae. 



For files assigned to printers* end~o f -f ile way be defined to be 
the sensing by the harduar& of the physical end of the page. In 
all cases* this is not actually the end of the page* but rather 
the sensing of a channel twelve punch in the Carriage Control 
Tape. This sensing will be reported to user progra«s* if 
requested by setting bit one in CT*A0V£R8 and by setting a bit in 
the FPB for the file. Notice that* because of the fact that the 
MCP is examining the result of I/O operations which may have been 
initiated some tiae ago* end-of-page is not reported when it 



occurs* but **n w write operations later* 
of buffers assigned to the file- 



where *n w is the number 



I/O errors are also reported to user programs on the WRITE 
communicate* if requested* This information is necessarily of 
little practical use* on any Burroughs operating systoar. 
Ostensibly* the I/O error routines of the HCPCs) should be of 
such a nature that the need to report this occurrence never 
ar i S8S* 



The same Data Communications applications which use bit three of 
the adverb on HEAD* use it in a similar mann&r on WRITE. When 

using this bit in the adverb* control is returned to the user 
when a WRITE is requested but the buffer that should be used is 
not yet available to the HCP* Again* this can be caused by the 
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Printer spacing information must be passed to the HCP or each 

WRITE communicate for a file which is assigned to a printer* 

This is accomplished by setting the proper bits in the adverb* as 
pictured in the preceding* 

Serial disk files may be opened by the user program for both 
input and output operations* In other words* the file fay be 
opened in such a manner that both a READ and a WRITE communicate 
are acceptable* with no intervening Close and Open. Hfoer this 
type of OPEN communicate occurs* the HCP will pre-fili ail of the 
buffers* as if the file had been opened INPUT only- but the 
buffers are released at different points in the READ and WRITE 
communicate processing* 

The HCP will not move buffer pointers at the conclusion of a READ 
communic ate* as i t normally does* Instead* it must wait until 
the next communicate operator associated with that fife is 
received* If the succeeding communicate is a WRITE* it will move 
the data from the work area to the buffer and change the 
operation code in the I/O descriptor to a Write* It will mark 
the program "ready to be reinstated** and then rotate the buffers 
in anticipation of the next communicate operator* In this 
specification* the term "rotate the buffers" means that the HCP 
moves the necessary buffer pointers and initiates the I/O if 
necessary* 

If the next communicate received at this point is a WRITE* the 
MCP* after insuring that the next buffer is available for use* 
will move the data again* from the work area to the buffer and 
rotate the buffer pointers* If the communicate had been a READ* 
the HCP would have moved the data in the opposite direction and 
it would not have rotated the buffer pointers. 

In summary* for this type of file* two successive READ operations 
wilt move two successive records from the file to the user's work 
area* Two successive WRITE operations will cause two successive 
records to be written into the file* A sequence of operations 
such as READ-WRITE-READ-WRITE will cause two successive records 
to be delivered to the user and the same records* but not 
necessarily the same data* to be written in the file. The 
£nd-of"File pointer for a sequential file may be extended when 
the file is opened in this manner* 



Disk files which contain variable-length records may not be 
opened for both input and output operations* or for random access 
processi ng. 
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For Sequential I/O files* a physical I/O operation is not 

necessarily initiated each time the user program does a WRITE. 

For blocked files* if the user has done a w"i*ITE on any record in 

the block* the operation will be initiated only when the buffer 
pointers are moved past the end of the block* 



For data communications files* the fields described as Cf.3 and 
CT.4 are used on H8ITE cofflrauni cates exactly as they are on READ 
communicates. 



For randod disk files a WRITE communicate may result In sore than 
one physical I/O operation. If the file is blocked* the block 
which contains the requested record must be in a buffer in memory 
before the record is Inserted in the block and actually written 
to disk. This Is due to the fact that the hardware can only 

initiate I/O operations and terminate them on segment boundaries. 



If the block which contains the requested record is not in memory 
when the WRITE is issued* the HCP will initiate a Read operation* 
force the requesting user to wait for its completion* move the 
record into its respective position in the block after the I/O 
completes* allow the user to be reinstated at this point and 
initiate the requested Write operation* if the file is being 
accessed in the RANQOH iode. 



In the 6.1 release of the software* a file access tsethod knonn as 
DELAYED RANDOM was i upleiented . When 0ELAYE9 RANDOM is used* the 
first request for a logical record of a given block of a DELAYED 
RANDOM file will result in a physical I/Q which reads the 
necessary block into semory* Subsequent accesses to the block 
will not generate any physical l/0»s as long as the block remains 
in memory. A block is overt ayed if a request is madQ for a block 
not currently in memory* at this time the least recently accessed 
block is chosen as the one to overlay. If the chosen block has 
oeen updated in me is or y it is written to disk before the new block 
is read. Periodically* all blocks that have been updated in 
memory are written to disk by the SMCP. 



SfilJS UUSfl K£l 



CT.VERB 
CT. OBJECT 
CT. ADVERB 
CT.l 

CT.2 

cr.3 



03 

FILE. NUMBER 



RANDOM FILE ACTUAL BINARY DISK KEY 
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The SEEK com/aunicate is an instruction to the MCP to position the 
arias property* on movable-arm devices* and to f i 4 i one of the 
buffers assigned to the file with the block of data which 
contains the requested logical record* This communicate is 

applicable to random disk files only* The user is not forced to 
wait for the completion of an I/O operation initiated by a SEEK 
communicate* He may be forced to wait if there is no buffer 

available to use for the operation* 

The SEEK communica te may be used by the user programmer to mask 
some or ail of the time required by a HEAD communicate with 
computation* It may also be used* prior to a HRITE commuricate* 
to eliminate the necessity of waiting for a buffer to be 
pre-filted when using blocked files* 

No data is moved to or from the user*s work area by the logic of 
a SEEK communicate* 



££§!££ CflUIfiflL 



CT.VER8 


04 




CT. OBJECT 


FILE 


•NUMBER 


CT.ADVER8 


8IT 






0-4 


- 




5 


TRANSFER 




6 


POCKET SELECT 




7 


STOP-FLOW 




8 


BATCH-COUNT 




9 


POCKET LIGHT 




10 


- 




11 


ENDORSE 


CT*l 


POCKET NUMBER 


CT.2 


BASE 


RELATIVE TRANSFER ADDRESS 


CT.3 


BIT 1 


LENGTH OF TRANSFERRED DATA 



The SORTER CONTROL communicate is used in confunction with files 
assigned to Reader-Sorters only* Such files may be utiliied 
properly in C080L programs only* Other languages may include 
portions of the syntax necessary for proper use of a 
Reader-Sorter* though only C030L contains everything that is 
necessary* 

When the MCP receives an I/O Complete interrupt from the 
Reader-Sorter* it immediately references the program which is 
using that sorter* determines the memory address of the "USE 
ROUTINE work area*** and places a formatted copy of the result 
descriptor from the I/O operation followed by an image of the 
item itself in the work area* It then reinstates the user at the 
code address of his USE ROUTINE* IFor additional information on 
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Item Processing* 
Number 105719F.) 



refer to the 9100O COBOL Reference Hanuat* For® 



The MCP takes the action described above regardless of other 
processing that is occurring* The action described is conitonly 
known as *Hi gh-Pr ior Sty Interrupt Handling"* 



Only three of the five possible adverb bits may be set in a 
communicate addressed to the HCP white the user program is 
executing the USE ROUTINE* These three bits are TRANSFER* 

STOP-FLOW and POCKET SELECT, The TfUNSFEfl bit is discussed in a 
subsequent paragraph. If the POCKET SELECT bit is set* the HCP 
use the value in CT.l as the pocket number on the sorter for 
item. If the STOP-FLOW bit is set in the adverb* the MCP 
issue the appropriate I/O Descriptor to the sorter. 

-. . . ,,ng the communicate* regardless ol the adverb bits* 

the MCP will continue doing whatever it was doing at the time the 
interrupt was received* the user Biust give up control at this 
point* 



will 

that 

wilt also 

After recefv 



Pocket selection on the sorter thus happens asynchronously with 
everything that is occurring on the system* except the sorter* 
This is currently the only device connected to the 81000 which 
operates in such a manner* The necessity for this action is 
dictated by the fact that the sorter is actually a "real-time* 
device and must be serviced in a specific time period after a 
check has been read by the hardware* 



The TRANSFER bit and its function was added to the 8*0 version of 
the nCPm When the TRANSFER bit is not set* which will be the 
case for all programs compiled prior to the 8.0 release of the 
software* the MCP* upon receiving the POCKET SELECT communicate* 
will dispatch the pocket number supplied to the sorter control 
and place an image of the item in a "tank* area in memory* The 

number of items that may be contained in the tank area is 
specified by the user and corresponds to the number 
requested for the sorter file* In actuality* there 
one buffer and I/O descriptor* regardless of 
requested* but the buffers requested will be used 
the size of the tank area. 



of buffers 
will te only 
the n u mb er 
to determine 



Item images will be removed from the tank when the user program 
does a SORTER READ operation on the sorter file. The images will 
be delivered in sequence to the program. Obviously* the tank 
area will become full if items are introduced to the system more 
rapidly than the user program does SORTER READ operations. If 

this occurs* the HCP will dispatch a STOP-FLOW I/O descriptor to 
the sorter control* tftus stopping the introduction of items* 
Flow will be automatically started by the HCP when the tark area 
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the system prevents 



is again empty- In this manner* 

and roo.LATE_TO.REAO conditions from 



If the TRANSFER bit is set in the SORTER CONTROL communicate* the 
HCP will not tank the actual image of the item but will store the 
data at the location specified by CT.2 and CT • 3 from the 
program's run structure* In this manner* the user nay cause the 
MCP to tanl< whatever he chooses* thus eliminating the need for 
several programming steps from the user program. A maxima® of 
one hundred characters may be passed and tanked per item. 



The BATCH-COUNT bit in the adverb 
counter on the sorter by one* 
HCP* This adverb bit will only I 
user program is not in the POCKET 
Priority Interrupt condition does 



is used to advance the batch 
each tine it is received by the 

e accepted by the HCP when the 
SELECT USE ROUTINE* and a High 
not exist* 



Each pocket on a Reader -Sorter has a red indicator lamp* visible 
to the operator* above it* The lights nay be turned or 

prograntaticall y by the object program issuing a SORTED CONTROL 
communicate with the POCKET LIGHT bit In the adverb set. Upon 
receiving such a communicate* the HCP will issue an 1/3 
descriptor to the sorter which will instruct it it turn on the 
light above the pocket specified by CT.l. The hardware wilt only 
take such action when the flow of items through the sorter has 
been stopped* The sane is true of the BATCH COUNT operation. 



33SI£B MM m££j. Mil 



CT.VERB 
CT. OBJECT 

CT. ADVERB 

CT.l 

CT.2 



05 
FILE.MUHBEft 

REAQ AREA SIT LENGTH 

REAO AREA 8ASE RELATIVE SIT AQOftESS 



Check Cite®) images are passed to the user program 
asynchronously* As described above* an item i sage is passed to 
the prograa whenever one is available to the system* The user 

program is expecting to REAO these images synchronously* however* 
by issuing SORTER REAO communicates. 



The MCP therefore temporarily stores these images in memory* 
passing them to the user program in succession* upon receiving 
this communicate. (Notice that the user program has already seen 
the images in his POCKET SELECT USE ROUTINE.) This operation is 
commonly known as "tanking"* 
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The operation of the SORTER READ communicate is similar to that 
of READ. Item images are passed to the user's work area by the 
MCP* tlie length and location of the work area Is specified by 
CT*1 and CT.2 respectively* 

There is actually a secondary purpose to the SORTER READ 
communicate! it informs the HCP fo the user programs processing 
rate* As described above* linages are passed immediately to the 
user for pocket selection out any other communicate froiB within a 
POCKET SELECT USE ROUTINE is prohibited. The images may not be 
written to disk or saved by the user in any manner* except when 
they are received vi a a SORTER READ communicate. 

Therefore* if the soft "tanks'* of item images maintained by the 
HCP begin to fill up* which indicates that the sorter is 
delivering images faster than the user can process them* the MCP 
will automatically stop flow on the sorter until the user program 
catches up* The sorter may therefore operate sporadically* in 
bursts* but all items will at least be pocket selected. 



The image of the item in the tank is preceded by a twenty-four 
digit €nlnety-six bit) expansion of the actual result descriptor 
received from the hardware in connection with that item. This is 
passed to the user program on the SORTER READ communicate* just 
as it is placed in his USE ROUTINE work area prior to reinstating 
hi s USE ROUTINE. 



Though only two communicate formats are implemented for use with 
Reader-Sorters* the HCP must do a lot more to make this operation 
possible. A program which opens a sorter causes many different 

items to be marka4 non-overl ay able in memory. This is described 
more fully under the OPEN communicate. For a more comprehensive 
explanation of Reader-Sorter operation* refer to the 81000 C080L 
Reference Manual* Form Number 1057197'* 
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CT.l DM. STATUS REGISTER SIT LENGTH 

CT.2 DM. STATUS REGISTER BASE RELATIVE BIT ADDRESS 

CT.3 DATA BASE NAME BASE RELATIVE SIT ADDRESS 

CT.4 DATA BASE NAME 8IT LENGTH 

CT.5 PACKIO 3A5E RELATIVE BIT ADDRESS C8IT QF 
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CT. ADVERB 
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ON EXCEPTION 




4-11 


am 


CT.l 


DM. STATUS REGISTER BIT LENGTH 


CT.2 


DM. STATUS REGISTER BASE RELATIVE 



BIT ADDRESS 



CT.VERB 08 

CT. OBJECT FILE •NUMBER 

CT. ADVERB BIT 

INPUT 

1 OUTPUT 

2 NEW FILE 

3 PUNCH 

4 PRINT 

5 NO REMIND/INTERPRET (DATA RECORDERS) 

6 REVERSE/POCKET CCA&D PUNCH) 

7 LOCK 

8 LOCKOUT 

9 REPORT FILE MISSING 

10 REPORT FILE LOCKED 

11 OVERRIDE NAMING CONVENTION AND SECURITY 
REINSTATE. MSG.PTR VALUES 

6000 OPEN 

1 FILE NOT PRESENT t INPUT DISK) 
PACK NOT PRESENT {OUTPUT OISK) 

NO MORE FILES ON MULTI-FILE REEL CTAPE) 

2 FILE LOCKED COISK FILES ONLY) 



The OPEN communicate serves primarily to associate a physical 
file with the logical file declared in the user's progras. Tha 

communicate has other functions and is also used when such an 
association has already been made* Basically* the processing 

invoked by an OPEN cowiuni cata obeys the rules set forth in the 
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definition of the CQ80L language 



The object program roust pass the unique file number assigned to 
the file by the compiler in CT. OBJECT. The MCP will use this 
number to obtain the disk address of the FP8 constructed by the 
compiler for that file. It will read the FP8 into memory* 

allocate memory to contain the FIB* the proper number of I/O 
descriptors and the buffer areas for the file- It will then 
construct the FI8* based upon the information in the FP8* the 
physical characteristics of the device assigned to the file and* 
in some cases* the logical characteristics of an existing file. 

The memory area allocated for a file is* except in the case of a 
Data Management file* a contiguous area. One meaory link only is 
necessary to describe a file area* The file area will contain 
all of the items mentioned in the preceding paragraph* FIBs vary 
in size* depending on the type of device assigned. No memory is 
allocated for this purpose until a device assignment has beer 
made • 



One of the first tests made in the OPEN routine is* "Is the file 
already Open?*** This is a violation of the rules of all 

languages and the MCP has no choice* if the test is true* but to 
discontinue the program* There cannot be two consecutive OPEN 
communicates on the same file without an intervening CLOSE 
communicate* 



Another preliminary test is * *Has a device assignment already 
been made?**. If true* the OPEN processing follows a different 
course. Device assignment is of prime importance to the QPEft 

routine. 



Osaice isjianisnl 1££££&1 Oisil 



A third preliminary test is whether or not the file is to be 
assigned to disk. If the file is a disk file* the course of 

action followed is described under the heading w 0isk File 
Assi gnraent ,, # The remainder of the discussion under Device 

Assignment applies to non-disk files* that are being Opened for 
the first time. 



The next major test made by the OPEN routine is whether the file 
is being opened for input* output or both. Only cert air card 
devices* such as Oata Recorders* may be opened for both input and 
output* exclusive of disk files. Certain other combinations of 
the various bits in the advero are also illegal. These will be 
discussed in turn. For the case mentioned above* attempting to 
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open a card reader* for example* for output purposes wi It result 
in the program being OS~ed by the MCP* 



If the file is being opened input* the HCP will attempt to match 

the FP3 of the file* FP8.HULTI.F ILE*ID and 
labels read previously by the STATUS 

If no natch is found* the 



the external names in 

FP8.FILE*ID* Mi th the 

routine on each peripheral device* 

operator is notified and the program is forced to wait urtil a 

file with the requested label is introduced to the system* 

until the operator resolves the *No File" condition is 

available to alloy 



or 
some other 



nanner. System SPO and Control Card syntax is 

tL ' -■ ^ '*■-- The program will removed from 



the operator this alternative* 
memory if possible* 



If a match is found on two or nore units* 
notified of this also and again* the program is 
The HCP cannot recover automatically from this 
operator must inform it that he has resolved the 
situation* Again* system SPO and Control 
available to do this* 



the operator is 
forced to wait* 
condition* the 
"Duplicate File* 

Card syntax is 



The MCP's Control Card routine is invoked whenever a card input 
device goes from a Not Ready condition to a Ready condition* The 
routine then reads the first card from the device* If this card* 
or in some cases* a subsequent card causes a job to be scheduled 
for execution* the Control Card routine retains control of the 
MCP* reads the next card* and processes it* It will continue to 
retain control until the card reader goes not ready* or urtil a 
DATA card is encountered* If the Control Card routine terminates 
processing due to the encountering of a DATA card* the physical 
input file described by the DATA card is associated with the last 
job which it placed in the schedule* This is only true if the 
Control Card routine did not lose control between the tine it 
encountered the card which caused a Job to be scheduled ard the 
time it encountered the DATA card* 

The MCP will not report a Duplicate File situation* if one 
exists* if the input file being opened is a card file or a 
pseudo-reader file and if the fob has a physical file associated 
with it in the manner described above* Rather* the HCP merely 
allows the associated physical file to be opened by the job- 
provided the external identifiers in the physical label and in 
the FPB are equal* 



Control Card syntax is provided to allow the operator to specify 
the physical unit which contains a specific logical file. This 
specification may be made when the |ob is scheduled for execution 
or it may be made permanently by modifying the FPB in the 
program*s code file on disk. If such a specification has beer 
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made* the HCP's OPEN routine ui 14 not attempt to match external 
identifiers* but will simply assign the physical file on the 
requested unit to the logical file being opened* provided* of 
course* that the unit is available for such an assignment* It 
should be noted that making such a specification in an FPB also 
changes the hardware type in the FP8 to match the hardware type 
of the unit specified. Units are specified by mnemonic naie« 

If the unit being opened is a tape unit* additional tests are 
necessary before the device may be assigned. The Reel Number 
field in the unit f s label must match the corresponding field in 
the logical file's FPB. For tape units* Multi-File Identifiers* 
File Identifiers and Reel Numbers must ail be equal. Also* in 
the case of a tape file* Control Card syntax is provided to alio, 
the operator to specify the Serial Number of a particular reel of 
tape. If this is done* alt four conditions must be met. As in 
the case of unit mnemonic specification* Serial Number 

specification may be made when the Job is scheduled for execution 
or it may be made permanently. 

The MCP will allow tape files to be opened when the user 
programmer does not know the logical record and physical block 
si2es actually written on the tape. These fields are left 

unspecified in the FPB by the compiler but the default bit in the 
FPB* FPdm DEFAULT* is turned on. The recording mode of a tape 
file may also be left unspecified if the bit is set. The MCP 
will insert the proper values into these fields when the tape is 
opened* provided the information is present in the tape*s label. 
If the information is not present* the program will be 
discontinued when the OPEN is attempted. 



The HCP will also insert values for record and block sizss when 
ail card input files are opened and FPB. DEFAULT is set. 



The MCP will discontinue any program which attempts to open a 
file contained on seven-track tape if the logical record size 
contained in the FPB for the file is not modulo six and if the 
programmer has specified the tape to be F2a4 without herd*are 
translation to EBCDIC. This is true regardless of which bit* 
Input or Output* is set in the Adverb. 

When the MCP receives a request to OPEN a file for output 
purposes* one of the first items that must be checked is whether 
or not the file should be assigned to a Backup device* which may 
be tape or disk. If the user has requested that the file be 
directed to backup* this will occur before the search for a 
suitable output unit is made. Backup capabilities are discussed 
in a separate part of this document. 
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Assuming that the file Is not to be sent to Backup* the MCP next 
checks to see if the user programmer has requested that the f i 4 a 
have special fores for output. This test is made for all output 
files* regardless of device type. If FP8.F0RWS is set to one* 
which indicates that special forms are required* the MCP will 
print an appropriate message and force the program to wait until 
the operator replies in the proper Manner* Syntax is provided to 
allow this* When the operator replies* the Q?£H routine is again 
invoiced and the file will be assigned to the device specified by 
the operator* is any* provided the unit available* 

In the absence of a Forms specification by the user* the MCP will 
search the I0A1 for an available unit of the type specified by 
FPB.HOWR* As described in a prior section* certain values which 
this field may contain are not actually hardware types but 
specify a group of types* such as "any tape"* "any head-per-tracfc 
disk** and so forth. In order to be available for output 

purposes* the unit must be ready* must not be currently in use by 
another program and must be write enabled. 

If the HCP cannot find an available unit of the type requested* 
it will check to see if it is permissible to direct the output to 
a Backup device* If so* it will attempt to do so. This is also 
discussed in the section of this specification describing the 
Backup operation* 

If there i s no available unit of the type specified by the user 
and if it is not permissible to direct the file to a Backup 
device* the MCP will print a message on the SPO to inform the 
operator that such a unit is required before the program* which 
will be identified* can proceed. The program will be forced to 
wait at this point* and will be removed from memory* if possible* 

The HCP may recover the program from this cord it ion 
automatically* with no operator intervention. If a suitable unit 
becomes available for output purposes* the OPEN comH!i.nicate 
processing for the program will be repeated* Control Card and 
Keyboard syntax is provided to allow the operator to override the 
hardware type specified in the user's FPB. Syntax is also 
provided to allow the operator to force the OPEN processing to be 
repeated* In this case* the MCP merely tries again. 

The MCP will automatically discontinue any program which attempts 

to OPEN* for output purposes* a file whose hardware type 

specifies a paper tape reader* a reader-sorter* a card read^rp a 
System SPO or an unknown device. 
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Certain devices on the 81000 may be opened for both input and 
output operations. These devices are ail card devices? no tape 
unit fflay be opened for both types of operations* except via the 
Emulator Tape constructs. At the present time* there are only 
three such devices* and they have come to be cotuBonly known as 
"Data Recorders". Actually* according to the 81000 Systeas 

Index* P»5. 1904 56 81* they are the? 

1. 89418-2 80-Colunn Keypunch-Printer 

2. 89419-2 96~Coiu?an Keypunch-Printer 

3. 89419-6 9&-Co4uffln Keypunch-Pr i nter-Sor ter 

All of the devices in the above list have one "Wait Station**. A 
Nait Station is used for hoidi ng the physical card after it has 
been read* or at least fed frosa the input hopper* and before it 
is printed or punched or both. Ail of the devices listed have at 
least one hardware buffer* capable of holding the information 
contained on one card. This buffer is used on input operations 
only. *Input w as used here will mean input to the computer. 



The table below present the number of input hoppers and output 
stackers on each physical device. 



lev ice Hoppers Stackers 

Onput) CQutput) 

19418-2 2 2 

19419-2 2 2 

19419-6 2 6 



Three different 1/0 Controls ar& used to interface the devices to 
the 81000 system. They are: 



1. HFC-1 (P. 5. 2208 3034) 
2* NFC-2 CP.S. 2208 3034J 
3. CfiPC {P. 3. 2211 1371) 



The following 1/0 operations are defined in the appropriate 
product specification for all of the controls. 



READ - (From the buffer in the peripheral)* This operation is 

known* for conversational purposes* as the REPEAT. READ. Valid 

vari ants ares 

Stacker Select 
Inhibit Feed 
Hopper Select 
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STACKER. SELECT. AND. READ - CfTead the information from the next 
card in the hopper 3* Valid variants are: 

Stacker Select 

Inhibit Feed 

Hopper Select 



PUNCH. Valid variants ar^i 
Stacker Select 
Inhibit Feed 
Hopper Seiect 

PRINT. Valid variants ami 
Stacker Select 
Inhibit Feed 
Hopper Seiect 

PUNCH-PRINT. Valid variants are* 
Stacker Select 
Unequal Data 
Inhibit Feed 
Hopper Select 

PUNCH-PHINT.AND.READ Valid variants are: 

Stacker Select 
Unequal Data 
Hopper Select 

The Stacker Select variant is actually a three-bit field in the 
I/O Descriptor. When the three bits are set to numeric values 
other than zero and seven* the device routes the card to the 
stacker selected by the descriptor. Valid nun eric values for the 
devices range from one to six* The MCP does not* an<i cannot* 
edit the numeric value passed by the object program to ascertain 
that it is valid for the connected device. 

The Unequal Data variant is valid only in I/O descriptors which 
cause a Punch-Print operation to be performed. If the variant is 
not set* the device will print the same information that is 
punched on the card. In other words* the beginning memory 
address for the information to toe printed is the sate as the 
beginning memory address for the information to be punched. If 

the variant is set* the information to be printed wilt be taken 
from a memory location which immediately follows the information 
that is punched. 

The Inhibit Feed variant causes the Wait Station in the device to 
be empty at the completion of the operation. No cards will be 
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fed from the 
descriptor. 



input hoppers if this variant is set i n the 



The Hopper Select variant causes the feed card to be taker from 
the secondary input hopper* if there is on^* If the Inhibit Feed 
variant is set* the Hopper Select variant is ignored* 

There is a 4 imitation* which was mentioned briefly in a prior 
paragraph. The MCP cannot distinguish between the 89419-2* which 
has two output stackers* and the 89419-6* which has six. The HCP 
does not edit stacker numbers before it sends them to the 
control- Therefore* programs which utilize alt six stackers on 
the 89419-6 say not be transported to systems which do not have 
such a device* Even if the HCP could distinguish between the two 
devices* the editing would have to be micro-coded and would 
seriously degrade performance* 



The capabilities available to the 
programmatical ty selected by variants on the OPEN 
by variants on the HEAD and WRITE communicates . 
is categorized according to the different 
available* 



object programmer 



am 
communicate and 

The discussion 
types of OPEN 



Hhen the HCP receives an OPEN request with none of the bits in 
the ADVERB area set* it will assume that the program only wants 
the information contained on the cards and does not intend to do 
stacker selection* Read-Punch operations* or any other variation 
available in the hardware. The I/O descriptors constructed as a 
result of this type of OPEN will all be of the Repeat. Read type. 
There may be any number of buffers associated with the file. Alt 
of the buffers will be filled when the file is opened. Stacker 
Selection is not allowed when the file is opened in this manner. 



When the nc? receives an OPEft request with the Pocket bit set* it 
will construct one descriptor * the operator field of which will 
contain a STACKER. SELECT .ANO .HEAD instruction. The buffer will 
not be filled when the file is opened. The first READ on the 
file will cause the first card in the data deck to be moved past 
the read head and stopped in the Wait Station. The data from the 
card will be transferred to the object program's work area before 
control is returned to the program. Stacker Select information 
passed on the first read may or may not be passed on to the 
device and will have no effect at alt* 



The second and all subsequent reads should have Stacker Selection 

information associated with them. The MCP will not* however* 

include code to insure this* The MCP will not allow more than 
one buffer to be associated with this type of file. 
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This action is distinctly different frost the fost common type of 
READ request handled by the HCP. The actual operation is always 
issued after the communicate is received* and never before* as it 
is with almost all types of input files. The I/O operation can 
n^yer be comleted ahead of the demand for it. This operation is* 
however* similar to the current HCP action for Sequential I/O 
files on Disk. The file can actually be thought of as an 
In put/ Output file* for all practical purposes. It »ust be 
considered such a file by the HCP* in order for the I/O to be 
initiated at the ^ro^er time in a card read cycle. The OUTPUT 
bit in the OPEN adverb should never be set wben the OPEN is 
requested* however. This will cause the communicate to have an 
entirely different meaning. 

Quite obviously* due to the differences in timing* it is 
mandatory that the object program close and re-open the file in 
order to change from pure INPUT to INPUT WITH STACKERS* and 
conver sel y . 



A number of variations are possible when 
an output file. There variations at&i 



the device is opened as 



1. 
2. 
3. 

4. 



PUNCH 
PRINT 

INTERPRET 
POCKET 



The Pocket variant may be applied to any of the first four 
variations* or it may be the only adverb associated with the OPE* 
statement. The HCP* upon receiving an OPEN communicate without 
PUNCH* PRINT or INTERPRET requested* will assume that Ptnch is 
desired. Therefore* OPEN OUTPUT is equivalent to OPEN OUTPUT 
WITH PUNCH and OPEN OUTPUT WITH STACKERS is equivalent to OPE^i 
OUTPUT WITH PUNCH* STACKERS. 



OPEN OUTPUT WITH PRINT 
punch anything into 
information. 



leans that the program does not want to 
the cards. It only wants to print 



OPEN OUTPUT WITH PU^CH* PRINT means that the program wants to 
punch information into the cards and wants to print different 
information on thei. The HCP will allocate the number of buffers 
requested by the program; each buffer will be 192 bytes long. 
The MCP will expect to receive 192 bytes of information or each 
WRITE communicate* 96 of which will be punched in the card and 96 
of which will be printed. As always* it is not mandatory that 
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the program deliver the full -192 bytes*. The save from the work 
area to the buffer Is left-Justified with blank fill. 

OPEN OUTPUT WITH INTERPRET means that the program warts to punch 
96 bytes of information into the cards and print the sane data. 
The NCP will allocate the number of buffers requested? which 
must be at least two* each will be 98 bytes in length. The I/O 
descriptor constructed will specify a PUNCH-PPINT operation* and 
the UNEQUAL DATA bit will be set to zero. The INTERPRET request 
will have precedence over PUNCH* PRINT and a combination of the 
two. OPEN OUTPUT WITH PUNCH* PRINT* INTERPRET should profcably be 
rejected as a syntax error by the compilers. The MCP will accept 
the communica te* however* and assume that the programmer meant 
only INTERPRET. The safe applies to OPEN OUTPUT WITH PUNCH* 
INTERPRET and OPEN OUTPUT WITH PRINT* INTERPRET. 

The POCKET variant lay be specified on any valid request for an 
OPEN OUTPUT. The variant is ignored by the HCP on the OPEN 
request. This is not true for OPEN INPUT WITH STACKERS. It must 
be true for OPEN OUTPUT* however* to avoid problems which may 
arise when the device assigned to the file is changed by a FILE 
card or an w OU* message. The NRITE communicate contains a bit 
which requests stacker selection. The HCP examines this bit and 
takes appropriate action on each WRITE communicate. 

All of the variations possible when a file is opened OUTPUT are 
also possible when the file is opened INPUT. OUTPUT When the NCP 
receives an OPEN INPUT. OUTPUT request with none of the variants 
set* it assumes that the user wants to read the information from 
the cards* and punch additional information into them* anti print 
the same information on them. Therefore* OPEN INPUT. OUTPUT is 
equivalent to OPEN INPUT. OUTPUT WITH INTERPRET. 

The adverbs PUNCH and PRINT are relatively useless when the file 
is opened INPUT. OUTPUT. Both punching and printing occur when 
the PUNCH-PRINT. AND. READ I/O operator is dispatched to tha 
control. There is no way the device can be made to print an4 
read or punch and read only. These opeations can be simulated* 
of course* by setting the UNEQUAL. DATA bit in the descriptor and 
loading the proper portion of the buffer with blanks. This 
requires some action on the part of the programmer. 



The UNEQUAL. DATA bit is set in the I/O descriptor when the MCP 



receives an OPEN communicate with both 
set in the adverb. As in the case of 
bit has precedence oyer both PUNCH and 
WITH PUNCH* PRINT* INTERPRET should be 
by the compilers. When the MCP 



the PUNCH and PRINT bits 
OPEN OUTPUT* the INTERPRET 
PRINT. OPEN INPUT. OUTPUT 
considered a syntax error 
receives such a request* 



however* it generates a PUNCH -PRINT. AND. READ I/O descriptor with 
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Files opened with various 
various number of buffers- 



attributes require or can only use 



Attr ibutes 



Requires 



Can Use 



Input only* not Stackers 
Input only with Stackers 
Output only 
Output and Input 



inf i ni te 

1 
inf ini te 

5 



If the number of buffers specified for a file is Cess than the 
nuBber required* it will be allocated the number required- If 
the number specified is more than the number that can be 
effectively used* it will be allocated only the number ft can 
use* 

As in the case of OPEN INPUT WITH STACKERS* the WCP will not fill 
the buffers when the file is opened* The first READ issued for 
the file will cause a card to be fed* read and stopped in the 
wait station* The information from the card will be passed to 
the oblect program at that point. It may be necessary for the 
tiC? to treat the first REAO on such a file differently from all 
other reads. This should be of no concern to either the corpiler 
or the object programmer* 

After the first READ on the file* the WCP will normally expect to 
receive two communicates for each card passed through the device. 
There shold be one WRITE request and one READ request for each 
physical card* The program should pass 96 bytes* or 192 bytes* 
of information to the MCP on each WRITE request. The information 
will be moved from the programs work area to the buffer on the 
WRITE communicate* The actual I/O operation will be initiated at 
this tiae and the program will be allowed to continue* without 
waiting for the completion of the operation. 

The MCP will normally expect to receive a READ communicate at 
this point* and the program may be forced to wait for the 
completion of the I/O operation issued previously. After 
completion* the information read from the card will be passed on 
the READ communicate* as always. 



It is not mandatory that the program always follow the READ/WRITE 
sequence described in the foregoing. If the prvqram issues two 
successive WRITE requests* the input information on one of the 
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cards involved will be lost to the program. The consequences if 
a program Issues two successive HEAD requests are somewhat sore 
dire* The information punched and printed on the first card will 
also be punched and printed on the second. Though this sounds 
rather bad* this could possibly be of some use to someone. 

Since the actual I/O operation for this type of OPEN is initiated 
on the WRITE communi cate * any stacker selection information must 
be passed along with the WRITE communicate. Stacker information 
passed on the REAO will be ignored. 

The MCP will automat ically discontinue programs that attempt to 
OPEN a file on any of these devices if- 

1. Neither the Input bit nor the Output bit is on in the 
Adverb* 

2. Both the Print ^ndi the Interpret bits are on in the adverb* 
or* 

3. The program is attempting to use a 96-calumn device in the 
binary recording mode. 

HI Ik UU Q££!i 

When a user program attempts to OPEN a file which is assigned to 
disk* the first test made in the Open Routine is whether the file 
is a new file which the program is creating for the first time or 
an old file which already exists in the disk directory. In the 
first case* a disk file header will eventually be constructed in 
memory by the OPEN routine. In the second case* the disk file 
header already exists and is stored in the directory and wilt 
have to be brought into memory by the Routine. The Open 
procedure for a new file will be discussed first. 

Programs which attempt to opvm new files for input and output in 
the serial access mode will be automatically discontinued at this 
point. Also* programs which attempt to open a new Hulti-Pack 
File and have blanks in the PACK. 10 field or the FP8 will be 
automatically discontinued. 

If the Open communicate specifies that the file is a code file* 
the proper names for the file will toe stored in the FP8 at this 
point. Also* the number of disk areas requested in the FP8 will 
be automatically set to one. The fact that this is a code file 
will be recorded by the HCP in the FP8 for the file. This 

information is required whan the file is closed. 
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If the PACK. ID field of the FPB contains something other than 
EBCDIC blanks* the program is requesting that the file be 
directed to a user pack with that 10. The HCP Hill* at this 
point* examine the Pack Information Table Maintained in memory 
for a pack with the corresponding identifier. If such a pack is 
the system* the routine continues. Otherwise* if the 
requested that he be notified when the pack is not 
setting the REPORT FILE HISSING bit in the adverb* he 
notified at this point and control will be returned to 



present on 
user has 
present by 

will be so 



the user through the noma! processor queue mechanisms. 



If the REPORT FILE HISSING bit is not set* a message to the 
operator will be displayed and the program will be suspended 
until the requested pack is introduced to the system or the 
operaor overrides the PACK. 10 specified. Control syntax is 
provided to allow the operator several means of accomplishing 
this. 



If the file being opened is a multipack file and if the serial 
number of the physical pack is zero or if the pack is already a 
continuation pack for another multipack file* the program will be 
automatically discontinued* If the number of areas requested for 
the file by the programmer is greater than 105* it will be 
automatically set to 105 by the HCP* In the latter case* no 
warning is sent to the operator. 

Memory for the file header is allocated at this point. If the 
user had requested that the disk areas to be assigned to the file 
be allocated when the file is opened* the allocation is done at 
this point* provided sufficient disk is available. If sufficient 
disk is not available* the program is suspended and an 
appropriate message is displayed on the 5P0. 



The File Header is no fc constructed in memory* based upon 

information contained In the FPB. The ultimate dispensation 

the header is dependent upon the type of CLOSE 
performed on the file. 



of 
commun icate 



At this point in the QPEH processing* the logic becomes the same 
for new and old files. Before proceeding with a description of 
the logic at this point* it will be advantageous to describe the 
processing which occurs when the user opens an existing file. 



When the user requests an Open of an existing file* the first 
occurrence is a determination of whether or not the file is 
present on the system. All three names in the FPB must match an 
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if the name fields contain something other than 



If the PACK. 10 Field is blanks the file is assumed to reside on 
system disk* The directory on the system disk will be searched. 
If the PACK. ID field Is not blanks* it specifies that the file 
exists on a removable user pack of that nane. If there is no 
such pack on the system at that tine* the program is suspended* 
with an appropriate operator message* until the pack is 
introduced to the system or the operator overrides the PACK. ID in 
the FP8. There are several means provided for the operator to 
accomplish this. If the REPORT. FILE. KISSING bit is set in the 
communicate adverb* the program is not suspended* but control is 
returned to it through the normal processor queues and the fact 
that the pack is not present is reported to it. In either case* 
the OPEN cannot proceed past this point. 

After the decision above* the HCP next searches the directory on 
system disk or on a user pack for a file identified by the names 
in FP8.NFID and FPB.IB. If the file is not found* the action is 
identical to that described above* If the file is found* further 
decisions ar& necessary. 



If the LOCK bit is set in the OPEN adverb* 
users who are writing to the file. There 
the file* but none of them may be using the 
the LOCKOUT bit is set in the OPEN adverb* 



there may be no other 
may foe other users of 
file for output. If 
there may be no other 



users of the file* the user who is presently opening the file 
must be the sole user. If these conditions are not met* an 
operator message is displayed at%d* depending upon the setting of 
the REPORT FILE LOCKED bit in the adverb* the user is either 
suspending or notified of the condition. 



Assuming that all of the conditions specified are met 
satisfactorily* the File Header is brought into memory by the 
HCP* if it is not there already* and the user count field in the 
header is incremented. If the OUTPUT bit in the adverb is set* 
the output user count field is also incremented. 

At this point in the OPEN processing* all of the paths converge. 
If the file is not a disk file* a device has been assigned to it. 
If the file is a disk file* the File Header is in memory and its 
associated disk areas* if any* are essentially "assigned" to the 
file. The File Information Block CFIB) must now be constructed. 



Construction of the FI8 is a rather mechanical process. After 
initializing certain fields in the I/O Assignment Table (I0AT3* 
memory to contain the FIB is allocated* if this has not already 
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occurred, 
at located 
assigned* 



As mentioned in a prior section* the amount of memory 
for an FIB is dependent upon the type of device 



The FIS itself is constructed from information contained in the 
FPB» froas information in the Of sk File Header* and fro* the 
parameters passed in the OPEN communicate. After this occurs* 
the I/O descriptors are constructed. Memory space which contains 
the I/O descriptors and their associated buffers is allocated 
with the FIB* such that the FIS contains not only the file 
information but also the descriptors and buffer areas. The 
memory necessary is then a contiguous block. This statement does 
not appty to Data Management System buffers* which are allocated 
separately. 

For serial* input only files* each I/O descriptor is initiated as 
it is constructed* The buffers are hence "pre-f illed" by the 
operating system when the file is opened. This is true of all 
files except those assigned to a reader-sorter and those assigned 
to a data recorder where the user has specified that stacker 
selection is to be performed on the cards. 

For output files which are not assigned to disk* labels are 
constructed and written according to the user's specifications. 
Tape labels are discussed in the portion of this document which 
describes Magnetic fa^a Management. For input files* the device 
assigned will be positioned such that the first READ issued by 
the program yeilds the first physical record froi the device. 
This is often accomplished by the Open routine. 

If the user has requested that translation be performed by the 
software* menory to contain the Translation Table specified by 
the user is allocated by the Open routine. The Translation Taola 
is also brought into memory by the Open routine and pointers to 
it are constructed in the FIB. If the specified Translation 
Table is not present on disk at the time of the Open* the program 
is suspended and an appropriate operator message is displayed. 



If the LOG System Option is set* entries are made in the tog when 
the file is opened. The FP8 for the file is also the log entry 
and certain fields therin are updated and sodified. At tha 
conclusion of the Open processing* control is returned to tha 
user if OPEN was invoked by a communicate* In alt languages 
except COBOL* OPEN may be invoked by a READ* WRITE or SEEK 
communicate. If this was the case* control is returned to the 
appropriate communicate handler via the systems processor queues. 
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CT*VER8 

Cf.QBJECr 

CT.ADVER9 



09 

FILE. NUMBER 
811 

REEL 

1 RELEASE 

2 PURGE 

3 REMOVE 

4 CRUNCH 

5 NO REWIND 

6 OVERRIDE NAME 

I LOCK 

8 IF NOT CLOSED 

9 ROLLOUT 

10 AUDIT SWITCH 

II TERMINATE 



CONVENTION AND SECURITY 



The CLOSE communicate allows the user to specify the dispensation 
of files that he has created- Should a program terminate without 
performing a Close on any file that he has opened* the MCP wilt 
assume that the device assigned to the file Is to be returned to 
the system* s resources and that the data contained in the file 
should not be retained. 

A second purpose of the Close routine is to bring the I/O 
activity on a device* which happens soaewhat asynchronously with 
a program's processing* to an orderly halt. It also returns any 
memory assigned to the file to the system* Clearly* an I/C 

descriptor and buffer area cannot be returned to available memory 
until the I/O operation it describes is complete. In order to 
accomplish this* it is often necessary for the Close routine to 
give up control of the processor and regain it when certain 1/3 
operations go to completion* 



The first test performed by the Close routine is whether or not 
the file has ever been opened* A CLOSE communicate issued for 
such a file is considered a programming error and the program 
witl be discontinued at this point* This is done primarily to 
inform the object programmer of the fact that there is something 
is wrong* 



The second test performed by the Close routine is whether or not 
the file is open now. It i s considered a programming error if a 
user requests a Close on a file that is already closed* as 
opposed to never having been opened* if the IF NO? CLOSED bit is 
not set in the CLOSE communicate adverb* The program will be 
automatically discontinued if this error is detected. If the IF 
NOT CL0SE0 bit is set in the adverb and the file is already 
closed* control is returned to the user program through the 
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normal processor queue mechanise. Alt other felts in the adverb 
wilt have no effect and the file is not closed a second time. 

Before proceeding with a description of the mechanics of the 
CLOSE communicate* it will be beneficial . to explain the function 
of the various bits in the adverb. The REEL bit is used or files 
which are assigned to magnetic tape only. It is ignored by the 
code if the file is assigned to any other device. It causes the 
«CP to close the reel of magnetic tape that is currently being 
processed. The file will be closed and the reel will be locked 
by the MCP. If the user program issues another OPEN communicate 
for the file* the next reel of the file* in numerical . sequence* 
wilt be sought by the Open routine. 

It i s not necessary for the user program to issue CLOSE REEL 
communicates when the physical end of the reel is encountered. 
This is done automat ically by the HCP. Reel-to-reel transition 
is accomplished without the involvement of the user program* 

The RELEASE bit in the adverb means that the resources assigned 
to the file are to be returned to the system. New disk files 
which are closed with RELEASE will have their assigned disk 
areas* if any* returned to the list of available disk. Permanent 
disk files which are closed with RELEASE will have their user 
count fields decremented but will remain in the disk directory. 
Devices other than disk will be marked available for use by other 
jobs* provided their physical status permits. 



The PURGE function is applicable to files assigned to disk or 
tape only. It is ignored if the file is assigned to other 
devices. If a CLOSE PURGE is performed on a file which is 
assigned to a tape unit* the tape reel will be rewotnd and 
purged* provided it is wr it e-enabled. If it is not 
wr ite-enabled* CLOSE PURGE will be equivalent to CLOSE RELEASE. 
For a permanent disk file which is closed with PURGE* the file is 
removed from the directory* provided the user who is doing the 
CLOSE is the sole user of the file* and the disk space assigned 
to the file will be returned to the available table. A new disk 
known as a *tempor ar y M file* will not yet be entered 
directory* but the disk space assigned to it will be 
the available table also. In the case of a temporary 
can be only one user and it is not necessary to check 
before purging* 



file* often 
in the disk 
returned to 
file* there 
user counts 



The LOCK bit in the adverb is intended to be used on files which 
are assigned to disk and tape only. It is ignored if the file is 
assigned to other devices. Uhen a file assigned to tape is 
closed with LOCK* the tape reel Is rewound and the unites status 
is marked as "Locked'* in the I0AT. The unit will not be 



7 -Ik 

BURROUGHS CORPORATION COMPANY CONFIDENTIAL 

COMPUTER 5Y5TCMS GROUP 81000 HCP II 

SANTA BARBARA PLANT P . S . 2212 5462 CE> 

available for use by other jobs until the operator intervenes* 
either by making the unit not ready amd then making it ready or 
by entering a "Ready* message on the SPO. The intended purpose 
of this function is to prevent the MCP from assigning the unit to 
other jobs before the operator has had a chance to refove any 
tape files which may have been created on the unit. 

The LOCK bit* when set on a CLOSE directed to a file which is 
assigned to disk* causes the file to be entered in the disk 
directory if it is a temporary file* subject to the restrictions 
below* If the file is a permanent file which is already in the 
directory* the LOCK function is equivalent to the RELEASE 
# unc ti on. 

A file n?ay not have its name entered In the disk directory if 
there is already a file by that name in the directory. A user 
who attempts to CLOSE LOCK a file* the name of which is already 
in the directory causes what is known as a "Duplicate Library* 
condition. The program will be suspended at this point and an 
operator message describing the conflict will be displayed. The 
operator must intervene at this point and cause the existing file 
to b« removed* or instruct the MCP to change the CLOSE LOCK 
communicate to a CLOSE PURGE or CLOSE RELEASE. Syntax is 
provided to allow this. 

The REMOVE bit In the adverb is intended to be used on disk files 
only. Its function is to allow temporary disk files to be Closed 
with LOCK without operator intervention. It operates in a manner 
similar to CLOSE LOCK except that if a Duplicate Library 
condition arises* the existing file is removed from the directory 
and the disk space assigned to it is returned to the available 
table automatically. The function is performed by the HCP with 
no operator intervention required. The new disk file is then 
entered into the directory and control is returned to the user. 

The CRUNCH bit in the adverb was originally intended for use by 
the compilers. This restriction is not enforced* however* and it 
may be used by any program whose source language includes the 
construct necessary to set the bit in the Communicate format. 
Its purpose is to return any disk that was requested but not used 
by the file to the available disk table. The unused disk must 
lie beyond the End-of-File pointer for the file and the file may 
have no more than one disk area assigned to it. When a Close 
with CRUNCH operation is performed on a file* always in 
conjunction with the LOCK bit* the number of segments per area in 
the file header is modified by the Close routine such that it is 
exactly equal to the amount of disk used. The header is then 
written to disk* per the LOCK bit* and the unused space is 
returned to the system. 
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The NO REMIND bit when set Is applicable to magnetic tape files 
only- It causes the magnetic tape to be positioned tm»ediately 
beyond the last label record written. The unit regains assigned 
to the program and is not available for use by anyone else* The 
user then has the option of opening another file in the forward 
direction* thus creating or continuing a multi-file tape* or of 
opening the file lust written as input in the reverse direction. 

The IF MOT CLOSED bit allows a user to close a file that is 
already closed. Ordinarily* this is a programming error and will 
result in the user's being terminated by the MCP* as described in 
a prior paragraph. This bit is sorely a weans of avoiding 
termination- 
File Information Blocks* I/O descriptors and buffer areas require 
substantial amounts of memory. The ROLLOUT bit in a CLOSE 

Communicate was provided to allow a user to temporarily close a 
file* leaving the associated device assigned to the program* and 
have the FI8 stored on di sfc so that it does not waste memory 
space. When the file is reopened* it is merely a matter of 
reading the FIB in from disk* updating certain fields therin* and 
proceeding. This is often quicker than recreating the entire FI8 
and it elimiates the possibility of another program gaining 
control of the peripheral device in the interim. 

The TERMINATE bit in the CLOSE adverb is set when the HCP's 
termination routines call the Close routine* This occurs only 
when a program terminates* normally or abnormally* and the 
peripheral devices are still assigned to the program. 

The NCP insures that the external names associated with a file 
assigned to disk are proper names when the file is closed. Khen 
a compiler closes the code file it has generated* the external 
names of the file are inserted by the Close routine based upon 
information supplied by the user in the Compile Control Card. 
Also* the MCP will not allow a disk file to be closed with LOCK 
with a blank multi-file ID* The internal name of the fiie will 
be inserted in FP8.HFI0 and an operator message will be printed 
when this is attempted. 

The FP8.L0CK boolean* if set* will cause the LOCK bit in the 
CLOSE adverb to be turned on when the file is closed* provided 
the TERMINATE bit is also set. This causes the file to be 

entered in the disk directory and was added as an aid to 
debugging. Occasionally* when a program has a fatal error* disk 
files that the program was using at the time ar& helpful to the 
object programmer in determining what caused the error* Locking 
the file in the directory enables the programmer to look at the 
data he was processing when the error occurred* 
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The CRUNCH bit in the adverb wilt be turned on automatically by 
the MCP if the file being closed is a backup file* a pseudo-dec*? 
or a code file* The LOCK bit will be turned on if the file is 
backup fits or a code file and if it should be 
director y. This latter case can only be 

information contained on the Compile card which 
available to the compiler* 



a 

entered in the 
determined from 
i s not readi ly 



Any file which was opened with the output bit set in the OPEN 
adverb* any file to which the user may have been issuing WRITE 
communicates* requires some special attention by the HCP during 
the Close procedure. Since physical I/O operations happen 
asynchronously with the user program* output I/O operations may 
have been initiated or narked ready for initiation and be 
incomplete or not even in process at the time the HCP receives 
the CLOSE communicate. Ihe actual Close operation must therefore 
wait for the completion of all output I/O operations associated 
with the file that is being closed. 



Input files present some similar problems. 
user # s buffers are filled when 
file is accessed serially* 

ahead of the user program 
as the user has read all o 
I/O operations may be in 
when the file is closed. 



Since all of the 

the file is opened* provided the 

and since the MCP attempts to stay 

in initiating I/O operations* as soon 

f the records from a buffer* physical 

process or marked ready for initiation 

In the case of an input file* it is not 



necessary for the HCP to wait for I/O completion. Any operations 
which have not been physically initiated may be cancelled by 
removing them from the channel chain. The HCP must wait for the 
completion of any I/O operations that are already physically in 
process* but this is a relatively short time period. 



In the case of Sequential I/O and Delayed Random disk files* the 
data in the buffer may have been altered by a Write operation 
from the user but the I/O descriptor may not yet have been marked 
ready for initiation. The Close routine will insure that all 
such buffers are actually written to disk prior to the completion 
of the Close operation. Siailarly* for serial* blocked output 
files* the user may have dona several write operations but not 
yet filled an entire buffer. The I/O descriptor in this case 
also will not yet be marked ready for initiation but the buffer 
will contain data which must be written to the physical media. 
The Close routine will initiate all such operations and insure 
that they are completed satisfactorily before allowing the file 
to be closed. 



In order for the events described in the preceding paragraph to 
occur* the physical media must remain accessible. In other 
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words* if the unit goes not ready and there are I/O operations 
which must be completed before a Close can occur * the program 
will remain in a waiting condition until the unit goes back to j 
ready condition and the necessary operations are complete. 
Keyboard syntax is provided* however* to a!4ow the operator to 
override this restriction. The syntax should be used only when 
the user program is being aborted* The output data in the 

buffers will be lost if the syntax is invoked and the data in the 
file will be suspect. Further* if the device is a magnetic tape* 
the MCP will not be able to write closing tape marks and labels 
on the media and an I/O error will result when the tape is read. 
Possibly* no I/O error will result* which may be worse. 

The Close routine next begins operations which are dependent upon 
the type of device assigned. In the case of a card reader which 
is closed by a user* the device may contain cards which have not 
yet been read by the program. The HCP wilt cause the cards to be 
passed through the reader* stopping when the device goes not 
ready or wh&n the next control card is encountered. 

In the case of a reader-sorter* code segments would have been 
marked non-overl ayable in memory when the file was opened. These 
code segments will be marked overlayable by the Close routine* 
provided the user who issued the CLOSE is the sole user of a 
sorter. Reader-sorter files may only be closed when the flow ot 
documents is stopped. Also* they may only be Closed with 
Release. The MCP will interpret all Close operations on sorter 

files to be Close with Release* regardless of the setting of the 
RELEASE bit in the adverb. 

8y far* the most complicated processing occurs when the file is 
assigned to disk. If the file is a multipack file* the Base Pack 
must be on-line at the time of the Close. The Close procedure 
will not proceed past this point if it is not. 

The NCP next attempts to do the LOCK function described 

previously. New disk files will be entered in the disk 

directory* provided there is no file with an identical name 
already in the directory. 

Existing files in the disk directory cannot be removed under any 
circumstances if they arB in use. Similarly* files classified as 
"System" files cannot be removed* even though their user-count 
field in the disk header is zero. The HCP code file being used 
is an example of such a file. Existing files will be removed by 
the Close routine if the REMOVE bit is set in the CLOSE adverb or 
the RMOV system option is set* if the Close routine encounters a 
duplicate file in its processing. If neither of the above 

conditions are true* the program will be suspended at this point 
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and the operator aust intervene to resolve the conflict 



If the file is a permanent file and if the user has added records 
to the file white it was open* the end-of-file pointer in the 
file header wilt be adjusted by the Close routine* 



If the PURGE bit is set 
file or if the file 
Release* the disk 
available table* 



in the adverb and the file is a penanent 

was temporary and is being Closed with 

space used by the file is returned to the 



If the file being closed is assigned to taps* the Close routine 

writes tape aarks and labels on the tape* Also* the Close 

routine sends a rewind descriptor to the unit* if not prohibited 
by the type of Close being perforated. 

The information in the I0AT is updated by the Close routine. 
Test and Wait for Ready I/O descriptors are re-initiated* if 
appropriate. Alt of the user»s I/O descriptors are removed from 
the I/O chain. 



Information in the FPB is updated and stored on disk in the 
working copy of the F?B* Finally* the memory assigned to the 
file is returned to the syste«*s available memory. Control is 
returned to the user through the normal processor queue 
mechani s«s. 



EGmima im£&q nee im£M£ ules mum 



CT.VERB 

cr. object 

CT. ADVERB 



CT.l 



10 

FILE 

BIT 



1 

2 

3-/ 

3 

9 

10 

11 



,NUH8ER 

REPORT 
REPORT 
REPORT 



t RETURN TO USER ON EOF 

& RETURN TO USER ON PARITY 

& RETURN TO USER ON INCOMPLETE 



DEFINED 8Y SITS IN 
REINSTATE. MSG.PTR VALUES 

GQOO POSITION 

1 END OF FILE COR 

2 I/O ERROR 

3 INCOMPLETE I/O 



POSITION TO ZHQ OF FILE 

CT.l CONTAINS PRINTER CHANNEL NUH3ER 

CT.l CONTAINS RECORD COUNT AS A FIXED 

CT.l CONTAINS RECORD NUMBER DESIRED 

CT. ADVERB 



I/O 



NUMBER 



END OF PAGE ON PRINTER) 
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The POSITION communicate allows the user to change the physical 
and logical position on a file. It Is used with serial files 
only* of course* The file nay be assigned to disk* tape or to a 
printer. The communicate Is ignored if the file is assigned to 
any other device* 

Positioning a printer file wilt be discussed first. If tha 
POSITION communicate is directed to a printer file* CT.l will 
contain either a channel number which wit! correspond to a punch 
in a carriage control tape* or a number which Mill specify the 
number of lines the printer should be spaced. If bit 10 in 
CT*AQV£R8 is on* CT.l will be assumed to contain the channel 
number. If the bit is off* CT.l will be assusned to contain the 
nufaber of lines* 

The Position routine will always space the printer the number of 
lines requested* Due to the design of the 91000 Printer 

Controls* it spaces the printer two lines per descriptor and* if 
the number of lines requested was an odd number* issues a space 
operator for one line to complete the operation* If a channel 
twelve punch in the carriage control tape is reported anytime 
during the spacing* End-of-page is reported to the progra* when 
the operation is complete* It is therefore possible* though 
highly inefficient* to cause several pages of paper to be passed 
through the printer with one POSITION communicate. End-cf-page 
is always reported to the user* if it was reported to the MCP* 
regardless of whether of not he has included code to handle the 
situation. Programs are not automatically discontinued if there 
is no such code* 



If CT.l contains a channel number* and if the channel nuaber is 
less than twelve* the routine constructs and sends an I/G 
descriptor to cause the printer to space to the recuestec 
channel. If the channel number if CT.l is twelve or greater* a 
message is printed on the SPO and the corcmun icat e is ignored. 

With some restrictions* disk files may be positioned forward or 
backward a specific number of records or they may be positioned 
to a specific record number within the file or they may be 
positioned to the end of the file* The file »ay be opened for 
input or for output but it say not be opened for both* 

Random disk files and files with variable length records way not 
be positioned at all. Attempting to do so will result in the MCP 
automatically discontinuing the program. 

Input disk files may be positioned to the end of the file* out 
may not be positioned beyond* Attempting to do so will result in 
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the file being positioned to the end of the file. Output disk 
files may be positioned beyond the end-of-file pointer but may 
not be positioned beyond the declared physical bounds of the 
file, The "declared physical bounds'* of a file are the number of 
records per area declared tines the number of areas in the file 
declar at i on. 



Files ®ay not be positioned to a negative record nunber. 
Attempting to do so will result in the file being positioned to 
the first record in the file automatically* 



In 



all cases mentioned above * the first bit in the adverb nust be 
set. Attempting to position a disk file 

end-of-file pointer or to the first record 



or 

record will result in 
program if the Report and 
applicable regardless of 
output purposes* 



to or beyond the 

in the file or a prior 

the HCP automatically discontinuing the 
Return EOF bit is not set. This is 

whether the file is opened for input or 



Files assigned to tape may also be positioned forward and 
backward* provided the file does not contain variable-length 



records* Attempting to position such a 
program being discontinued by the HCP* 
positioned to the first record in 
end-of -the~f He* provided the first bit 
the same manner as disk files. 



file will result in the 
Also* tape files will be 
a file or to the 
in the adverb is set* in 



In order to function properly* the HCP maintains a record count 
for all tape files on a "per reel" basis. When the Position 
routine receives the communicate* it first computes the record 
number desired by the program. If the record count desired 

exceeds the current record count* the tape is positioned in the 
forward direction to the desired record* 



The record count for any reel of tape is set to zero when the 
file is opened. This is applicable regardless of the type of 
Close previously performed on the file* if there was a prior 
Close* Hence* when a tape reel is opened in the reverse 
direction* Record One is actually the last physical record on the 
tape. The "forward" direction is therefore defined to be the 
direction that the tape is currently being passed. When a file 
is opened reverse* a "Backspace" operation will cause it to wove 
toward the physical end of the reel. 



Tape files may not be positioned to the end of the file if the 
file is opened output or if it is opened reverse or if it is not 
an ANSII-labeled tape* When a Position to end-of-file occurs* 
the record count field maintained by the MCP will be lost* since 
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the I/O operator addressed to the unit will be a "Space to Tape 
Mark". The record count field must therefore be recovered from 
the ending label and ANSII labels are the only labels which 
guarantee that a record count field is present. 

The 31000 tape subsystem is capable of spacing tape one physical 
record per I/O operation or to a tape mar km It is not capable of 
spacing for a specified number of physical blocks with ore I/O 
descriptor- Hence* spacing to a specific record occurs one block 
at a time. Irrecoverable I/O errors encountered on any of the 
blocks will result in the program's being automatically 
discontinued by the MCP if the second bit in the adverb is not 
set* If the second bit is set* the I/O error will be reported to 
the program and the position communicate will be terminated- At 
this point* the record count field maintained by the MCP will not 
be reliable. 



If a tape mark is encountered while the MCP is spacing the tape 
to a specific record* End-of-File will be reported to the progran 
if the first bit in the adverb is set- The program will be 

automatically discontinued if it is not* 



A£££23 £IL£ £1&JB£IIS 


CT.VERB 


11 


CT. OBJECT 


FILE.HUM8ER 


CT.ADVEPB 


SIT 




0-10 - 




11 0=R£A9 




1=WRITE 


CT.l 


RECEIVING FIELD 



2LS£iS LZtn 



BIT LENGTH 
CT.2 DECEIVING flELO BASE RELATIVE BIT ADDRESS 

The ACCESS. FPB Communicate allows the user access to any of his 
File Parameter Slocks* The working copy only of the FPB way be 
accessed by this communicate. The FP8 is read directly from disk 
into the user's run structure. The address and size passed in 
the communicate oust lie wholly within the run structure. The 
program witl be automatically discontinued by the MCP if this 
rule is violated. 



Information is not formatted by the MCP. If the FPB definition 
in the MCP is changed for any release of the software* it is the 
user*s responsibility to make corresponding changes in his 
pr ogram. 

The communicate operation is ignored if CT. OBJECT specifies a 
file which is non-existent or if the user attempts to read less 
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than 56 bits of an FP3. 



Changes made to the FP8 while the file Is open wilt rot be 
effective until the file is opened again* Due to the fact that 
the Close procedures use fields in the FPB* changing a File 
Parameter Block white a file is open may result in unpredictable 
errors and even system halts. 



M££££ Ulg IMMMIIM BLflfifi HIM 



CT-VER8 


12 


CT.G8JECT 


FILE.NUHBER 


CT. ADVERB 


BIT 




0-10 - 




11 FORMA 



CT.i 
CT.2 



O-CHARACTER 
1=BINARY 

RECEIVING FIELD BIT LENGTH 
RECEIVING FIELD SASE RELATIVE 



3IT ADDRESS 



The ACCESS. FI8 communicate does not really access the entire FIB. 
It returns only the End-of-File pointer and the type of hardware 
device assigned to the file* It returns these items in either 
binary or decimal format. The £nd-of-FHe pointer is twenty-four 
bits or eight bytes. The hardware type is six bits or two bytes 
respecti vely » 

Programs will be automatically discontinued if the receivirg file 
is not wholly contained within the program's run structure. An 

ACCESS-FIB cGfofRUn icate for a file that is not open hilt be 
ignored. 

MM Q2E8UI 

CT.VER8 13 

CT.QSJECT 8ASE RELATIVE SIT ADDRESS OF 76 BIT FIELD IN FORMAT OF 

4 BITS 

24 BITS BEGINNING ADDRESS 

24 BITS ENDING ADDRESS 

24 SITS RELATIVE DISK ADDRESS 



This communicate is issued by programs which are written in SOL 
and which include paged arrays only. The SDL Compiler generates 
code which manages the paged array space and this communicate is 
the raeans whereby it transfers information in the paged arrays to 
and from disk. 



BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 



7-4S 

CQHPANY CONFIDENTIAL 

31000 MCP II 

P.S. 2212 5462 CE) 



The area described by the fields listed above must lie wholly 
within the program's run structure. Violation of this rule will 
result in the automatic discontinuation of the program. 

The relative disk address passed wust lie within the disk overlay 
area allocated to the program* This has been discussed 

previously under proqtam 80J facilities* 

Que to hardware limitations* the overlay area can be no smaller 
than 56 bi ts. 



This communicate is not used by C080L* RPS or 
written in a source language other than SDL. 



any other pro gran 



This communicate uses the program's overlay descriptor in the Run 
Structure Nucleus. The program is placed in the WAIT. 9 until the 
I/O operation initiated by the procedure goes to completion. At 
that time* control is returned to the program through the normal 
processor queues. 
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CT.VERB 
CT. OBJECT 



14 



BASE RELATIVE ADDRESS OF 30 CHARACTER FILE IDENTIFIER 
PACK.ID CAT HFID CAT FIO 
CT. ADVERB BIT 
0-5 

6 OVERRIDE USERCQOE NAMING CONVENTION AND SECURITY 

7 REPORT SECURITY VIOLATION 

10-11 0=WRITE 
I=READ 

2=REAO & FORMAT IN BINARY 

3=READ t FORMAT IN CHARACTERS 
CT.l RECEIVING FIELD BIT LENGTH 

CT.Z RECEIVING FIELD BASE RELATIVE BIT ADDRESS 
REINSTATE. MSG.PTR VALUES 

COMMUNICATE COMPLETE 

1 FILE NOT PRESENT OR SECURITY VIOLATION AND 

CT. ADVERB BIT 7=0 

2 SECURITY VIOLATION AND CT. ADVERB BIT 7=1 



This cQiBfflunicate allows the user access to disfc file headers 
contained in the system's disk directory. The receiving or 
sending file described by CT.l and CT.2 must lie within tha 
program's run structure. If it does not* the program hill be 
automatically discontinued by the MCP. The field in the run 
structure which specifies the file identifier aust be exactly 
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thirty characters in length and must conform to the fixed 
described in the Communicate layout above. 



format 



This communicate has four variations as defined by CT. ADVERB. If 
CT -ADVERB contains a zero or a one* the sending or receivinq 
field is assumed to correspond exactly to the current definition 
of a disk file header. The "current" definition lears the 

definition used in the actual MCP that is handling the 
communicate operator* and not the definition used in any 
subsequent HCP. 



If CT. ADVERB is set to zero* certain fields ar& moved from the 
programs run structure to the actual disk file header and 
written to the disk directory. Only selected fields may be 

written? those not selected are ignored. 

If CT.AQVER3 is a one* information is moved directly from the 
file header to the receiving field specified. The sove is 
le ft-| usti f ied with zero fill. The entire file header iray be 
read in this manner. 



If CT. A OVER 9 is a two or a three* the fields listed in the table 
below only are moved to the program's run structure. The 

formatted move also occurs ief t-Just if ied with no filling. If 
the receiving field Is not sufficfentiy long* the move is merely 
truncated from the right. 



FIELD NAME 

OPEN. TYPE 

NO. USERS C Number of Users) 

RECORD. SIZE 

RECOR0S.PER. BLOCK 

EOF. POINTER 

SEGMENTS. PER. AREA 

USERS, OPEN. OUTPUT 

FILE. TYPE 

PERHANENT 

eLOCKS.PER.AREA 

AREAS.RQST CRequested) 

AREA. COUNTER 

SAVE. FACTOR 

CREATION. GATE 

ACCESS. DATE CLast) 

REC.SIZE 

HPF (Hulti-Pack File) 

PROTECTION 

PROTECTION. 10 



LENGTH 


LENGTH 


C8ITS) 


CCHAHACTERS) 


24 


1 


24 


2 


24 


4 


24 


4 


24 


8 


24 


8 


24 


I 


24 


2 


24 


I 


24 


6 


24 


3 


24 


3 


24 


3 


24 


5 


24 


5 


- 


5 


1 


1 


2 


1 


2 


1 
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the file is not present in the dssfc directory * the orogram is 
notified by inserting a one in the RS. REINSTATE. HSG.PTR. In 

either case* control is returned to the program through the 
norial processor queue atechani so? • 



UmiMQIll LM2 



CT.VER8 
CT. OBJECT 
CT. ADVERB 



CT.l 
CT.2 
CT.3 
CT.4 
CT.5 
CT.S 



15 

INVOKE 

8IT 

1 
2 



3 
4 

5 
6-10 



NUN8ER & PATH NUHSER OF THE PATH-NAHE 

RETURN LIST HEADS CREORG ONLY) 

RETURN LOGICAL ADDRESS (REORG ONLY) 

OH. STATUS FQRHAT 

0=8INARY 

1=4-8IT DECIMAL 

ON EXCEPTION 



MODIFY 

SELECTION EXPRESSION 

NEXT 

1 PRIOR 

2 FIRST 

3 LAST 

4 NEXT AT 

5 CURRENT 

6 AT 

11 DATA SET SELECTION EXPRESSION 

DJU STATUS REGISTER SIT LENGTH 

DH. STATUS REGISTER BASE RELATIVE 8IT ADDRESS 

OATASET RECORD WORK AREA SIT LENGTH 

OATASET RECORD WORK AREA 8A5E RELATIVE 8IT ADDRESS 

SEARCH KEY CCAT OF COMPONENT NAMES) BASE RELATIVE 3IT 

INVOKE NUN8ER I PATH NOHBER OF DATASET-NAHE 



ADR 



Refer to P.S. 2212 5470 
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INVOKE NUNBER & PATH NUMBER 

CSU6SET IF INSERT) 
BIT 

INSERT 
1 

2 DM. STATUS FORMAT 
0=QINARY 
1=4-8IT DECIMAL 

3 ON EXCEPTION 

4 BEGIN TRANSACTION CNOT INSERT) 

5 1NCLUDES.LIST. HEADS CREORG ONLY) 

6 END TRANSACTION CNOT INSERT) 



7-*S 
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CT.l 
CT.2 
CT.3 

CT.* 



7 NO AUDIT (BEGIN OR END TRANSACTION ONLY) 

8 SYNC CENQ TRANSACTION ONLY) 

10 STORE INDEXES ONLY (REGRG ONLY) 

11 PSEUOO CREATE (REORG ONLY) 
DM. STATUS REGISTER SIT LENGTH 

DM. STATUS REGISTER 3ASE RELATIVE BIT ADDRESS 
OATASET RECORD VIORK AREA BIT LENGTH (NOT INSERT) 
INVOKE NUMBER « PATH NUMBER Of OATASET (INSERT) 
DATASET RECORD WORK AREA BASE RELATIVE BIT ADDRESS 
(NOT INSERT) 



Refer to P.S. 



2212 5*70. 
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CT.VER8 
CT. OBJECT 

CT.AQVERB 



CT.l 
CT.2 
CT.3 

CT.* 



17 

INVOKE NUMBER & PATH NUMBER 

(SUBSET If REMOVE) 

8IT 

REMOVE 

1 

2 DM. STATUS FORMAT 
0-BINARY 
I=*-8IT DECIMAL 

3 ON EXCEPTION 
*-lt - 

DM. STATUS REGISTER SIT LENGTH 

ON. STATUS REGISTER BASE RELATIVE 8IT ADDRESS 
OATASET RECORD MORK AREA BIT LENGTH (NOT REMOVE) 
INVOKE NUMBER I PATH NUMBER OF OATASET (REMOVE) 
OATASET RECORD WORK AREA BASE RELATIVE BIT ADDRESS 

(NOT INSERT) 



Refer to P.S. 2212 5*70. 
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CT.VER6 
CT. OBJECT 
CT. ADVERB 



CT 

CT 



INVOKE 

SIT 



1 

2 



NUMBER & PATH NUMBER 



3 ON 
*-il - 

DM. STATUS 
OM. STATUS 



RECREATE 

ON. STATUS FORMAT 

0=8INARY 

l-*-flIT DECIMAL 

ON EXCEPTION 



REGISTER 
REGISTER 



31 T LENGTH 

3ASE RELATIVE 



BIT ADDRESS 
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CT.3 
CT.4 



OATASET RECORD WORK AREA 
DATASET RECORD WORK AREA 



BIT LENGTH 
BASE RELATIVE 



3IT ADDRESS 



Refer to P. 5. 2212 5470. 
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CT. OBJECT 


FILE.NUH3ER 


CT.iADVERB 


BIT 




0-f NOT USEO 




8-11 = REAO FORWARD 




1 = READ REVERSE 




4 = WRITE 



REINSTATE. NSG.PTR VALUES 

GQOO SHXTCH 

1 FILE mi QPEU 

2 WRONG DIRECTION 

3 ENO OF FILE 



OR NOT A TAPE FILE 



This operator was added to facilitate the implementation of the 

Tape Sort feature. It has found use in other applications since 

that time. Essentially* it merely changes the direction of a 

tape file without ti me-consumi ng Close and Open Invocation. 



There is no way that this communicate can cause discontinuation 
of a program. Ail errors are merely reported to the program. 
The file may be changed from input to output* provided it is not 
being read in the reverse direction. Direction may be charged or 
the same communicate which changes the I/O mode. In other words* 
a file may be changed from input and reverse to output and 
forward with one communicate* 



Buffers are filled by the HCP as a function of this communicate. 
No fields in the FI8 are changed* however. Consequently* use of 
this communicate is not practical on blocked files. 

This communicate will not function if one of the file*s buffers 
has already encountered the physical end of the file. 



umiMii mat bmi 

CT.VER8 20 



This Communicate calls the Terminate Procedure directly. Tha 

Terminate Procedure is also called when a program is being 
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discontinued- There is very little difference between a normal 
terminate procedure* where the routine is called via a 
Communicate and an abnormal one* where the procedure is called by 
the NCP to discontinue a program* 

Programs may not be terminated if they are using a reader-sorter 
and the device is operating* In this case* the terminate 
rountine will wait until the flow is stopped on the sorter and 
then proceed with the termination* This is due to the fact that 
High-Priority Interrupts from the sorter can only be handled in 
code written exclusively for that purpose- At any rate* alt of 
this will be transparent to the user and the program wilt be 
terminated* though not necessarily at the time the Terminate 
Procedure is first invoked* 

A similar situation exists if the program has Data Management 
operations in process* I/O Complete on such an operation can 
only be handled by Data Nanagement code* and the Terminate 
Procedure will be forced to wait for completion of any such 
operations. 

The Terminate Procedure may also have to watt for Roll-in and 
Roll-Out operations to be completed. The progra* must be present 
in memory before it can be terminated. 

As mentioned previously* all of the conditions listed to this 
point are transparent to the user. The Terminate Procedure has 
its own mechanisms for waiting for such events to be complete. 
No action is required on the part of the user* 

The queue of keyboard messages entered via the Accept response 
will be purged of any messages intended for this program at this 
point. Refer to the Software Operational Suide explanation of 
the W AX W message for details on this queue. 

At this point* the Terminate Procedure will wait for any code or 
data overlays which may be in process to go to completion. The 
Terminate Procedure* if it must wait for such an event * yields 
control to the outer loop of the MCP. The Procedure will be 
continued when the I/O goes to completion. 

Any I/O operation which was initiated by the program and which 
did not use the normal File I/O mechanism will be halted and 
delinked from the channel chain at this point. Examples of such 
operations are disk I/O initiated by the Oisk Initialization 
utilities and all Oata Communications I/O operations. Temporary 
disk storage obtained by the MCP to execute the program is 
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The Terminate Procedure next proceeds to close all the files 
which are associated with the program and which are not yet 



closed by a user with no bits set in the 
HQ RE HIND bit set in the adverb is not 
HCP. The unit* in these cases* regains 
even though there can be no I/O in 
The unit must be returned to the list of 
the program terminates* Files are 
always Closed with Release by the Terminate Procedure* except 
when the file is assigned to disk and FPB.LOCK is set. 



closed* A file which is 
Close Adverb or with the 
considered closed by the 
assigned to the program* 
process for the file* 
available resources when 



The Terminate Procedure next performs those functions associated 
with memory assigned to the program* The code segment dictionary 
user count is decremented* If it becomes zero- memory occurpies 
by the code segments and the segment dictionary is returned to 
the available memory list* Similarly* the user count for the 
Interpreter used by the program is decremented. If it becomes 
zero* memory occupied by the interpreter and its segments is also 
returned. If the interpreter was partially or totally resident 
in H-Hemory* it is removed. This may result in a change in tha 
mode of M-Nemory management. If so* it is performed at this 
point. 

Similar functions are performed on any Intrinsic Code the program 
may have been using* The user count for the Intrinsic File and 
for the Code file itself aro decremented and stored in the disk 
file header in the disk directory. 

If the Log option is set* the Log is updated at this point. In 
addition to the type of termination* a count of code overlays* a 
count of data overlays* the current time and date and the amount 
of processor time used by the program are stored in the Log* 

The program** overlay descriptor is removed from the disk chain* 
a SPO message is printed if the EOJ option is set- and if this 
program was executed by another using the PROGRAM. CALL 
communicate* ttie calling program is marked ready to run. Memory 
occupied by the programfs run structure is returned to the 
available pool. The number of fobs running is decremented. A 
bit is set which will cause the next execution of the OUTER. LOOP 
to check the active job schedule. 



If any programs are in the Halting schedule and are waiting for 
the successful termination of this program* they are moved to the 
Active schedule* provided this is a normal termination. If this 
program was a "Compile and Go* or a "Compile and Save"* the code 
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file generated is placed In the active schedule. 



0£I 


imi 


CT.VER8 
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CT. OBJECT 


INVOKE NUMBER & PATH NUMBER 


CT. ADVERB 


BIT 




0-1 




2 OM^STATUS FORMAT 




Q=BINARY 




i=4-8IT DECIMAL 




3 ON EXCEPTION 




4-11 



CT.l 
CT.2 



OM-STATUS REGISTER dIT LENGTH 

DM. STATUS REGISTER BASE RELATIVE BIT ADORESS 



Refer to P*S. 2212 5470 
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CT.VERB 
CT. OBJECT 
CT.ADVER8 



22 

BASE RELATIVE BIT ADORESS OF WHERE TO PUT THE RESULT 

BIT 

1=DAFE REQUESTED 

1-2 FORMAT 

YY/DDD (JULIAN) 

1 MM/OO/YY 

2 YY/MM/QQ 

3 DD/MM/YY 

3-4 REPRESENTATION 

BINARY 

1 4-8IT DECIMAL 

2 3-8IT DECIMAL 

5 1=TIM£ REQUESTED 

8-7 FORMAT 

COUNTER 

1 HHSMMSSS.S C 24-HOUR CLOCK) 

2 HH:MMsSS,S TT (12-HOUR CLOCK* TT=AN/FM) 
8-9 REPRESENTATION 

BINARY 

1 4-8IT DECIMAL 

2 8-8IT DECIMAL 

10 1=TQDAYS.NAME REQUESTED 

11 
NOTE S TODAYS. NAME RETURNS 9 CHARACTERS LEFT JUSTIFIED 

FORMAT BINARY 4-3IT DECIMAL B-BIT DECIMAL 

•*•»•••• • » » • mm » m » * <• * * * * » » • » * - 

YY/DDO (JULIANA 7*9=16 
MM/DD/YY 4*5*7=16 



4-3IT DECIMAL 

8*12=20 16*24=40 
8*8*8=24 16+16*16=48 
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YY/MN/DD 7*4*5=16 8*8*8=24 16*16*16=48 

DQ/MM/YY 5*4*7=16 8*8*=24 16*16*16=48 

COUNTER 20 2* *3 

HH:NH:SS.S 5*6+6*4=21 -8 + 8*8 + 4=28 16*16*16*8-56 

HHtNNSSS.S TT 4*6*6+4*16=36 8*8*8+4*16=44 16*16*16*8*16=72 

TODAYS. NAME 7Z <9 CHAR, LEFT JUST 

CT.VER8 23 

CT. OBJECT BASE RELATIVE ADDRESS OF 

6 3YTE UNIT MNEMONIC 
OR 

I/O DESCRIPTOR 
CT. ADVERB VALUE 

ASSIGN UNIT TO THIS PROGHAM 
i RELEASE UNIT 

2 INVALID 

3 LINK IN THE I/O DESCRIPTOR AND INITIATE 

4 INVALID 
REINSTATE. MSG.PTR VALUES 

IF CT.ADVER8=Q THEN 

PORT, CHANNEL AND U^IT OF DEVICE REQUESTED 

PORT SIT 13> 

CHANNEL BIT C4) 

FILLER BIT CD 

UNIT BIT <4) 
ALL OTHER CASES 

GOOD COMMUNICATE 

1 DISPATCH TO INVALID PORT OR CHANNEL 

This coanunicate is intended for in-piant use only. Anyone 
outsit of Santa Barbara Plant who attempts to use this 
communicate does so at his own risk* The cotaffiunicate format and 
function way be changed from time to tiae. No notice of such 
change will be supplied to any user prior to the change. Such 
information will be available on request. 

Released MCP*s will not allow a Write descriptor to be initiated 
on system disk. Attempting to do so will result in the proqra?a*s 
being OS-ed. 

The HCP does not assure that the A and 8 addresses in the I/O 
Descriptor are bounded by the programs Base/Li«it registers. It 
is the programmer *s responsibility to do this. Failure to do so 
will result in unidentifiable system halts. 

To use this conaunica te* the programmer should first issue it 
with CT. ADVERB set to zero and CT. OBJECT pointing to a 
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six-character unit mnemonic. If the requested unit is not 

available for any reason* the catling program will be QS-ed. If 
the unit is available* it Mitt be assigned to the catling 
program* It is possible to read any unit without requesting that 
the unit he assigned to you* 



After the unit is assigned to the program* the communicate may be 
issued with CT. ADVERB set to two or threes The WCP copies the 
I/O Descriptor outside the base-limit before it links irto the 
chain. When the I/O completes* the 10. ACTUAL. END and 10. RESULT 
are moved back into the base-limit area. When the I/O operation 
is completed* the I/O descriptor is removed from the associated 
channel chain. In order to again execute the I/O* the program 
must issue another communicate with CT. ADVERB set to two or 
three. 



The program should issue the co 
one before it goes to end-of-|ob. 



imunicate with CT.A9VERS set to 



It should be emphasized that this communicate was added to the 
MCP for purposes of on-line pack Initialization only and is 
intended for use only by that program* in the form supplied by 
Santa Barbara Plant. Requests for maintenance or support from 
any other source will be ignored* 
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CT.VER8 
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CT. OBJECT 


LENGTH OF TIME IN 10THS 


FUNCTION 


PROGRAM IS PUT TO SLEEP 



OF A SECOND 
FOR SPECIFIED 



LENGTH OF TI^E 



lit 

CT.VER8 
CT. OBJECT 
CT. ADVERB 
CT.l 
CT.2 



25 



3IT LENGTH 
8ASE RELATIVE 



MESSAGE AREA 
MESSAGE AREA 
REINSTATE. MSG.PTR VALUES 

HQ ERRORS IN ZIP TEXT 

1 ZIPPED INVALID CONTROL 



SIT ADDRESS 



CA80 



This communicate provides a means for programs to pass control 

cards and keyboard messages to the HCP. There are no 

restrictions on the messages which may be passed. No messages 

are returned to the program by this procedure* the only 

information returned is an indication of whether or not the 
syntax of the control instruction was valid* 
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Any program placed in the schedule as a result of a control 
message received from a ZIP Communicate wilt execute 
asynchronously with and independently of the program which 
executed the ZIP* unless progr afloat ic «eans for synchronizing the 
two programs are provided in the programs. 

If the control instructions passed via the ZIP communicate are 
invalid* a message is printed on the SPO to inform the system 
operator of the occurrence. This is necessary* since invalid 
control instructions can result in incorrect operational 
behavior • 



A££££I 
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CT. OBJECT 


- 


CT. ADVERB 


BIT 




RETURN IF NO MESSAGE 




1-11 - 


CT,1 


HESSAGE AREA BIT LENGTH 


CT.2 


MESSAGE AREA 8ASE RELATIVE BIT ADDRESS 


REIN5TAT£*MSG.PTR VALUES 




HESS AGE OF LENGTH ZERO 


3FFFFFF3 NO NESSAGE PRESENT 


ANY 1 


]TH£R VALUE LENGTH OF MESSAGE IN BITS 



This communicate was provided as a means of implementing the 
COBOL ACCEPT verb. Its use is not restricted to programs written 
in a particular language* il may be used by any program. 

The receiving field must tie within the bounds of the program f s 
run structure* The program will be forced to wait for an 
operator response if bit one in the adverb is a 2ero and if there 
is no message in the Accept Queue for the program* Control is 

returned to the program through the normal processor queues when 
a response from the operator is received* 



Messages ar& 
blank fill* 



moved to the receiving field left-Justified with 



J2J££UI 

CT.tfERB 2f 

CT*08JECT 
CT. ADVERB BIT 
0-10 
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11 



CT.l 
CT.2 



0=CRUNCH BLANKS OUT OF MESSAGE 
1=PRINT MESSAGE AS IS 
MESSAGE. AREA 8IT LENGTH 

MESSAGE AREA 8ASE RELATIVE SIT ADDRESS 



This communicate was provided as a means of implementing the 
C080L DISPLAY verb. Like ACCEPT* It may be used by any program. 
It serves merely to print the message described by CT.l and CI". 2 

on the SPO. 



If bit eleven in the adverb Is set* the MCP will reformat tha 
entire message such that non-blank fields in the message are 
separated by no more than one olank. This is merely a 
convenience for the user programmer which may be used when the 
spacing of the words in the message upon the SPO is not 
important. 



CT.VERB 28 



This communicate is not implemented, 
and control is returned to the user* 



If received* it is ignored 
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CT.VERB 
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CT. OBJECT 


BASE RELATIVE ADDRESS OF SQR 


CT.AOVERB 


BIT C12> 




1 - SORT. RESTART 




2 - SORT.OUPCHECK 




3 - SORT.Wl.PIO 




4 - SQRT.y2.PIQ 




5-12 FILLER 


CT.l 


BASE RELATIVE BIT ADDRESS OF 


CT.2 


INPUT FILE. NUMBER OR A9DR OF 



C T . 3 
CT.4 

CT.6 

cr.r 

CT.S 



INFORMATION TAELE 



SORT KEY TABLE 

MERGE. INPUT. TABLE IF SERGE 



OUTPUT FILE. NUMBER 
TRANSLATE FILE .NUMBER OR NOT 
GAT A. ADDRESS (DELETE .KEY .TABLE) 
IF CSGRT.WUPID := W1.PI0.FLAG) 

DATA. ADDRESS C«1*PI0) ELSE 
IF CSORI.y2.PID s= Vi2.PIQ.FLAG) 

OATA. ADDRESS CH2.PIB3 ELSE 



THEN 



'HEN 



This communicate provides a means for the user program to call 
the Sort Intrinsic* For details on the implementation* refer to 
the proper Sort or Herge Product Specification. 
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FLAGS 



This communicate is used by all interpreters which include Trace 
capabilities. Its use is snot restricted to SOL only. The 

communicate is merely a weans of turning the Trace on and off. 
The print line is passed via a type 61 interrupt fro* the 
interpreter* The code invoked by this interrupt is little more 
than a call on the SOL He ad /Write Procedure in the MCP. 



E4ULAXJ2& li££ ifllCSfl MQll 



CT.VERB 
CT. OBJECT 
CT. ADVERB 



CT.l 
CT.2 
CT.3 



31 
FILE 

BIT 
0-2 



3-8 



NUHBER 

OP. CODE 

= 

1 = 

2 = 

3 = 

4 = 
CODE 



QP 



READ 

WRITE 

SPACE 

REWIND 

TEST 

.VARIANT 



5 
6 

/-a 

9-11 
9 
10 
li 

USER 

USER 
USER 

BIT 



I 

2 

3 

4 

5 

6 

7 

a 

9 



3 = REVERSE CREAO* SPACE)* ERASE tWRITE)* 

TEST •WAIT. READY. NOT. RE WIND CTEST) 

4 = ONE. RECORD (SPACE)* TAPE. MARK CWRITE)* 

TEST. WAIT. NOT. READY (TEST) 
= 000. PARITY CREA9* SPACE* WRITE) 
= NOISE (READ* SPACE) 
= NOT USED 

SCHEDULING. VARIANTS 
= FETCH. RESULT 
a OONT.MAIT 
= REPORT ANO RETURN ON IC ERROR 



TAPE BUFFER BIT LENGTH 

TAPE BUFFER 3A5E RELATIVE ADDRESS 

ERROR HA5K C8IT SET IMPLIES USER WILL 

CORRESPONDING ERROR) 



HANDLE THE 



CNAY NOT USE) 
CNAY NOT USE) 
NOT READY 

PARITY (NOT ON TEST) 
ACCESS ChOT ON TEST) 
TRANSMISSION CON TEXT ONLY) 
END. OF. TAPE 
BEGINNING. OF. TAPE 
WRITE. LOCK. OUT 

END. OF .FILE CNOT ON TEST)* UNIT. PRESENT COfc 
TEST) 
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10 REWINDING 

11 TINE. OUT (NOT Oft TEST) 
12-16 CHAY NOT USE) 

17 SHORT. RECORD 

18 LONG.RECORD 

19 DROPOUT 

20 INITIATE. LATE 

21 CHAY NOT USE) 

22 TRANSMISSION. ERROR. NEC 

23 TR^NSHISSIQN.ERHOR.WTC 

CT.4 BASE RELATIVE ADDRESS OF USER'S 48 BIT RESULT 

8IT 0-23 OF RESULT CONTAIN THE RESULT DESCRIPTOR 
BIT 24-47 OF RESULT CONTAIN THE ACTUAL LENGTH 

REINSTATE. NSS.PTR VALUES 

- RESULT RETURNED 

1 = IG.ERROR 

2 = RESULT NOT AVAILABLE 

This communicate was added so that the Emulators of 
second-generation hardware produced by Santa Barbara Plant wight 
be operated under control of tha MCP. It was necessary to add a 
new communicate to do this* since programs written for these 
machines routinely manipulate magnetic tape In manners which 
violate the rules of the HCP*s logical I/O aechani sns. The 

normal file mechanisms in the HCP* which were promulgated upon 
the specifications of the COBOL language* ace certainly 

inadequate to allow all of the many tape operations which were 
coi»on to second generation machines. 

Essentially* the procedure builds an I/O descriptor according to 
the specifications passed by the communicate fornat and initiates 
it. The Emulator prograa is not allowed to execute until the I/O 
operation goes to completion. The procedure is re-entered at 
completion of the operation and the program is then allowed to 
cont inue. 

The procedure first tests to see if the file is Open. If it is 
not* the Open procedure is called directly from the cotiffunicate 
and control is returned to it when the open completes. At this 
point* the procedure continues provided the open was successful. 
If it was not* the emulator program would have been placed in one 
of the processor queues and marked waiting. In the latter case* 
the communicate procedure merely returns control to the outer 
loop of the HCP. 

The procedure next performs minor editing on the files passed ir 
the communicate format. If the operator request involves a date 
transfer* the buffer area described siust lie wholly within the 
bounds of the user's run structure. Due to hardware 
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restrictions* certain variants and combinations thereof are 
invalid for certain operation codes. The variants here are those 
passed in bits three through seven of the communicate adverb. 
Validity of the variants is checked by the procedure. If the 
user has violated either the bounds check or the variant check* 
the program is automatically discontinued by the HCP. 

The procedure n&xt constructs an I/O Descriptor which corresponds 
to that requested by the user. The I/O Descriptor is outside the 
user's run structure. A full tape file FIB is allocated* atong 
with space for one I/O descriptor* by the Open Procedure. This 
is done even though many of the fields in it are not used by the 
Emulator Tape Handier routines directly. Host of the fields are 
required by the Close Procedure. 

The requested I/O operation is then initiated and the program is 

marked waiting for its completion. Control is returned to the 

outer loop of the HCP at this point and the HCP is free to 
service other users. 

When the I/O operation completes* the procedure is again invoked. 
It first moves the result descriptor received with the I/O 
concatenated with a twenty-four bit field which will specify the 
actual length of the operation just completed. The length of the 
operation is specified in bits. Also* prior to doing the «ove of 
the result descriptor* the procedure verifies that the receiving 
field is within the run structure of the program. If it is not* 
the program is automatically discontinued. 

If the exception bit is set in the result descriptor* the 
procedure determines if the exception condition is one that the 
user has included code to handle himself. If it is* control is 
returned to the user through the normal processor queue 
mechanism. If the user does not have code to correct the error 
himself* the procedure calls the MCP*s I/O Error procedure 
directly. I/O Error wilt then retry a number of ti ires and 
eventually return control to the Emulator Tape Handler. If the 
error was irrecoverable* the program is discontinued. Otherwise* 
control is returned to the user* 



CT.VERB 32 

This communicate was added so that Job streaming may be 
terminated at the discretion of the user. It functions exactly 
as the STOP communicate does except that instead of a standard 
£nd-of-Job message* it causes "COBOL ABNORMAL END" to be printed 
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on the SPfl. Also* any programs that are in the Waiting Schedule 
waiting for this job to finish will not be moved to the active 
schedule by the abnormal termination* 



SJ28I £0J 



CT.VER8 
CT. OBJECT 
CT. ADVERB 
CT.l 

CT.2 



33 

FILE-NUMBER 
CLOSE IYPE 
ENO-OF-FILE 
RECORO SIZE 



POINTER 



This communicate serves to terminate* in a normal manner* the 
Sort and Herge Intrinsics and to return control to the catling 
program* For details on its operation* refer to the appropriate 
Sort or Merge product specification. 



0££Z££IMM Silfit SlftJttUIBE 
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CT. OBJECT 


8IT CHI6H 




0=THAH 




1=FR£EZE 



ORDER SIT) 



Depending upon the functions being performed by a user program* 
it may not be permissable for the MCP to change the memory 
location of the program's run structure or to roll it out to 
disk- The most obvious example of this is the Disk 

Initialization Utilities. yhich have actual I/O Descriptors 

within their run structure. There are several other such cases. 

The field in the Run Structure Nucleus- RS. TEMPORARY. FREEZE- 
gives notice to the MCP» s Roll Out procedures that this run 
structure may not be moved. This communicate provides a 

programmatic means of bumping and decrementing that field. 



CT VERB 36 

48*8ITS SOL DESCRIPTOR {WHERE TO PUT INFO) IN FORMAT : 

16 8ITS=LENGTH 

24 8IT5=ADQRESS 

RETURNS COMPILE CARD INFO IN FOLLOWING FORMAT : 

#CfiARS INFO 



30 

02 
10 



*•..».»**-»* .»»•■»* *•-»-«-** * • * * • • • • . » 

OBJECT NAME 

EXECUTE TYPE 

PACK. NAME OF THE RUNNING PROGRAM 
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30 INTERPRETER NAME OF THE RUNNING PROGRAM 

10 INTRINSIC NAHE {PACK I FAHILY) 

02 PRIORITY 

06 SESSION 

06 JOB NUMBER 

20 1ST I 2ND NAMES OF RUNNING PROGRAM 

Of CHARGE NUMBER 

01 FILLER 

56 BITS DATE COMPILED 

04 BITS FILLER 

10 USERCOOE 

10 PASSWORD 

04 PARENT JOB NUMBER 

20 PARENT QUEUE IDENTIFIER 

01 LOG SPO 

04 SECONDS BEFORE DECAY 

01 PRIVILEGED 

This communicate returns selected fields from the working copy of 
the Program Parameter Slock to the user*s run structure. The 

receiving field described by the SOL Descriptor must tie wholly 
within the run structure* The program will be automatically 
discontinued if it does not. The fields returned are presented 
in the fixed format shown in the table above. 



JUJSAt!i£ tOSil fii££ 

CT.VER8 37 

VALUE IS RETURNED IN COMMUNICATE MESSAGE POINTER AS 

SELF RELATIVE DESCRIPTOR 

This communicate returns the relative address of the dynamic* or 
overlayabte* area in the run structure. It is intended for use 
by programs written in SDL only. 

££tij)fix umi is una 

CT.VERS 38 

USEO 8Y ALL LANGUAGES* INCLUDING SDL. 

This communicate causes the program's run structure and other 
pertinent information to be dumped to disk and locked in the 
directory with a unique name. The information may be processed* 
formatted and printed later by a normal state program written for 
that purpose. 

Programs which are already in the process of terminating may not 
be dumped. This is academic in this case* however* since a 
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program which was terminating could not issue the coiiunicate. 
Programs which are rolled out to disk will be rolled back In and 
dumped* via an operators action* provided sufficient memory is 
available* Again* if the progf •• am were roiled out to disk* it 

could not possibly have issued the communica te » 

The amount of di sfc which will be required to contain the dump 
file usually exceeds by a considerable margin that required to 
contain fust the Base/Limit ar&a of the program. In addition to 
the run structure* the dump file will also contain the File 
Dictionary* the FI8*s and buffers* the Data Dictionary and all 
data segments* the code dictionary and the code segments which 
are present in memory at the time* and other miscellaneous 
information* If sufficient di sir is not available* a message wilt 
be printed on the SPO and a one will be returned to the program 
in RS.REIN5TATE.H5G.PTR. The program wit! be allowed to continue 
processi ng. 

The forsiat of a dump file is as follows* 

1» A "Pointer** record* which is described below. 

2. The program - * run structure and Run Structure Nucleus. 

3. The Data Dictionary. 

km Every data segment in the dictionary. Segments which are 
not in memory will be copied to the dump file from their 
4 oc at ion on disk. 

5. The File Dictionary. 

6. Each FIB and its associated I/O Descriptors and buffers. 
This includes all files that are open and those that are 
closed with no form of release. 

7. The wording copy of the Program Parameter Block. 

3. The working copy of the initial scratchpad settings. 

9. The working copies of all File Parameter Slocks. 

10. If the program is written in SOL* the LAYOUT. TABLE. 

Control is returned to the program through the normal processor 
queue mechanism. Actually* the program is marked ready to run 
after the scratchpad is copied. 

The format of the * l Pointer ,, record i s* 
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DUI*PFILE 

TIHE.QF. 

HCP. GATE 

RELEASE. 

LIMIT. HE 

QATA.DIC 

DATA.SEG 

FIB. QIC. 

FX8.PTR 

PPB.PTR 

NET.CQNT 

MCP.RELE 

LAYOUT.? 

LAYOUT, T 

DUMP. SYS 



•NUMBER 
DUMP 

MCP 

GISTER 

.PTR 

S.PTR 

PTR 



ROL.ftACRO 
ASE.LEVEL 
ABLE. PTR 
ABLE. SIZE 

TEH. 10 



8ITC24) 
eiT(36) 
BIT CIS) 
ITC4) 
ITC24) 
ITC24) 
ITC24) 
IH24) 
ITC24) 
ITC24) 
ITC4) 
ITC16) 
ITC24) 
ITC24) 
ITC12) 



Jul ian Oate plus 
HCP Version Oate 



Time 



X R 



el ative 
Ret ati ve 
Ret ati ve 
Relative 
Ret ati ve 
I if Data 



Dis* 

Disk 
Oisfr 
Of %k 
Disk 



Address 
Address 
Address 
Address 
Address 



Com municati ons Handler 



StZl 5£&iaif MMMR 



CT.VERB 
CT. OBJECT 



39 
SESSION 



IS PUT INTO RS. REINSTATE. HSG. PTR 



J2£^I!IIIIAJ£jiID 



CT.VERB 


40 


24 BITS 


PORT 


24 BITS 


-CHANNEL 


24 BITS 


BASE RELATIVE ADDRESS OF I/O DESCRIPTOR 



This co*municate provides the capability of initiatirg I/O 
descriptors on the data communications equipment which may be 
attached to a system. The I/O descriptor itself if constructed 
by the program* which is usually the Oata Communications Handler 
program generated by the NOL Compiler. This is not a 

requirement* however* and no test for this condition is fade by 
the code in the MCP. The communicate operator may be used by any 
program whose source language contains the proper syntax. 

The program will be automatically discontinued by the HCP if the 
requested I/O control is not a data communications control or if 
the control is already in use by another program. Also* if the 
address of the I/O descriptor does not lie within the program*s 
run structure or if the program attempts to initiate an I/O 
descriptor with the "high priority interrupt request* bit set* 
the program will be automatically discontinued. 



After the editing described above has be^n performed* the 
requested operation is initiated. Control is returned to the 
user through the normal processor queue mechanism. The program 
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is not forced to wait for the completion of the operation 

initiated? control is returned immediately after the initiation, 

CT.VER8 41 

CT. OBJECT INDICATES FUNCTION 

DESC1 BIT 1-46 MESSAGE AREA I 

DE5C2 8IT 49-96 MESSAGE AREA 2 

QUEUE. PTR BIT 97-106 REMOTE FILE NUMBER OR STATION NUMBER 



fl£UfiiI£ 

CT. OBJECT 11 

DESC1 RESULT AREA 

0ESC2 DC. WRITE MESSAGE 

NOTE: NUMBER A? $U8$TRCDESC2?6»2) IS HESSAGE TYPE 

40=FINISH OPEN 
*1«NDL/MACR9 PRESENT 
42=ATTACH STATIONS TO REMOTE FILE 
4$=0£TACH STATIONS FROM REMOTE FILE 



Syi£iS M£U£ jjfilll £3£iS2I£ ULZS2 

CT. OBJECT 12 

DESC1 HESSAGE HEADER 

0ESC2 MESSAGE 

RHT.FL REMOTE FILE TO WHICH THE MESSAGE IS DESTINED 



miz& zuzug mm izmiQM nummi 



CT. OBJECT 
DESCI 
DESC2 
ST.NR 



13 

MESSAGE HEADER 
MESSAGE 
STATION NUMBER 



4£££5S IiS£S£i2i2£ £IL£ 

CT.VERB 42 

OESC BIT 0-47 DESCRIPTOR TO PARAMETER LIST, 



PARAMETER LIST LAYOUT 
MODE BIT <43 

SET ALL PARAMETERS IN LIST EXCEPT USERCODE AND 

PASSWORD. THESE MUST BE SUPPLIED TO FIND 
CORRECT ENTRY. 

1 SET ALL PARAMETERS IN LIST EXCEPT INDEX. INDEX 

MUST BE SUPPLIED TO FIND ENTRY. 
Z SET OVERRIDE. USERCODE AND PASSWORD MUST BE 
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PRESENT TO FIND ENTRY. 

3 SET OVERRIDE. INDEX MUST BE SUPPLIED TO FIND ENTRY. 

4 ADD ENTRY. ALL FIELDS HAVE TO BE SUPPLIED. 

5 DELETE ENTRY. USERCOOE AND PASSWORD MUST BE 

SUPPLIED TO FIND ENTRY. 

6 INITIALIZE ALL OVERRIDE BITS. 

7 CHANGE 8Y USERCOOE. ALL ENTRIES FOR A GIVEN USER- 

CODE CAN BE CHANGED WITH ONE COMMUNICATE. USER- 
COOE MUST BE PRESENT. PACK FIELO MUST NOT BE 
EQUAL TO ZERO TO CHANGE IT. CHARGE NUMBER MUST 
NOT BE EQUAL TO ZERO TQ CHANGE IT. PRIORITY MUST 
NOT BE ESUAL TO ZERO TO CHANGE IT. 

3 DELETE ALL RECORDS FOR A GIVEN USERCOOE. USER- 
CODE MUST 8E PRESENT. 

9 SET ALL PARAMETERS IN LIST EXCEPT USERCOOE AND 

PASSWORD. ONLY USERCOOE HAS TO BE SUPPLIED 
BECAUSE SEARCH STOPS ON FIRST ENCOUNTER OF 
GIVEN USERCOOE. 

10 CHANGE 8Y INDEX. INDEX MUST BE PRESENT. 

PRIORITY CAN 8E CHANGED 8Y SETTING FIELD TO NON- 
ZERO. CHARGE CAN BE CHANGED BY SETTING CHARGE 
FIELD TO NON-ZERO. PASSWORD CAN BE CHANGED 8Y 
SETTING PASSWORD TO NON-ZERO. 

11 CLEAR PACK OVERRIDE FIELD FOR ALL OCCURRENCES OF 

THIS USERCOOE. USERCOOE MUST BE SUPPLIED. 

12 CLEAR PACK OVERRIDE BIT FOR ALL OCCURRENCES OF 

THIS USERCOOE. INDEX MUST BE SUPPLIED. 

INDEX BIT C10> 
USERCOOE CHARACTER < 10) 

WHEN SET 8Y PROGRAM CNQDE = 0> 2, 4» 5# 1* 8» 9, 11), 

THE USERCOOE MAY OR MAY NOT CONTAIN PARENTHESES. 

IF PARENS ARE NOT FOUND* ONLY THE FIRST EIGHT 

USED. 
WHEN SET 8Y MCP CMQOE = 1) 

USERCOOE WILL ALWAYS CONTAIN PARENTHESES. 
PASSWORD CHARACTER CIO) 
PACK NAME CHARACTER (10) 
CHARGE * BIT €24) 
PRIORITY BIT <4) 
PRIVILGD BIT CD 
OVERRIDE BIT <1) 
REINSTAT£,MSG.PTR VALUES 

NO ERRORS. 

1 ERROR ON INPUT: EITHER INDEX IS WRONG OR 
USERCODE/PASSWORD IS NOT PRESENT. 

2 "CSYSTEM^USERCJDE* FILE NOT IN "US" SLOT. 

CT.VERS 4% 

49 BITS SDL DESCRIPTOR 

24 BIT LENGTH OF TEXT 
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24 9IT 8ASE RELATIVE ADDRESS OF TEXT 

This coifflunicate functions in a manner similar to the ZIP 
communicate described previously* with one notable exception. 
The progran which issues this communicate is suspended* and 
removed from memory* until the program which is initiated by the 
communicate goes to end-of-Joo. This communicat e* then* provides 
a (Beans for one program to call another and wait for its 
completion. The text which is addressed by the forty-eight bits 
passed with the communicate should be valid MCP Control Card 
syntax which causes the execution of a program. 

Unfortunately* no means are provided for passing parameters 
between the two programs involved. This can be done only via the 
Fi4e mechanism of the HCP. The FILE Control Card* described in 
the Software Operational Guide* does provide soie assistance in 
this at* e a • 



The text passed by the communicate must tie within the programs 
run structure. The program will be au tomaticaily discontinued it 
it does not. No further editing is performed by the comrauri cate. 
The program which issued the communicate is not informed of the 
validity of the control syntax passed. 

CT.VER8 46 

CT. OBJECT 8ASE RELATIVE ADDRESS OF HESSAGE 

CT. ADVERB SIT 

i=L0AQEQ 0=OUMPE0 

1-11 - 



This coamunicate causes the thirty bytes beginning at the address 
specified by CT.Q9JECT concatenated with either the word "LOADED* 
or the word w 0UHPED w * depending upon the setting of bit I of the 
adverb* to be displayed upon the SPO if and only if the LI8 
system option is set. Refer to the Software Operational Guide 
for details on the LIB option. All non-blank EBCDIC fields in 
the message wi4l be shifted to the left before printing until 
they are separated by no more than one EBCDIC blank. 

££*£L£2 Mil IHi£5Q ££Ei 

CT.VERB hi 

CT. OBJECT NUMBER OF EVENTS 

CT. ADDERS FIRST EVENT TO CHECK (CHECKED IN CIRCULAR 

FASHION Fmn THIS POINT). 
CT.l-ETC. BIT ENCODED EVENTS C NUHBER SPECIFIED BY CT. OBJECT 
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MAX=15). 

0- 3 EVENT TYPE 

4- 7 EVENT PARAHi 

8-15 EVENT PARAN? 
16-24 EVENT PARAM3 
EVENT TYPES; 

- NULL - PARAM1#2*3 

1 - SPQ INPUT PRESENT 

2 - TIME - PARAMi,2»3 

FIELD CONTAINING 



: NOT USED 

- PARA«1#2»3 : NOT USED 
: CONCATENATED BIT 20 
THE LENGTH OF TINE TO 



3 - 



IF FILE IS 



WAIT IN 10THS OF A SECOND 
REAO OK -PARAMl: NOT USED* PARAM2: 
FILE NUMBER, PARAM33 MEMBER NUMBER 
fl-FILE -FAMILY 

4 - WRITE OK - PARAMl*2*3s 5AME AS READ OK 

5 - QUEUE WRITE OCCURRED - PARAHls NOT USEQ, 
PARAM2: FILE NUMBER OF Q-FILE-F ANIL Y* 
PARAM35 NOT USED 

6 - DATA COHH 10 COMPLETE - PARAM1*2,3: NOT USED 
VALUES 

ZERO RELATIVE INOEX TO THE COMMUNICATE EVENT LIST ELEMENT 
WHICH IS COMPLETE 



REINSTATE. M5G.PTR 



tiE££A££ mmi 



CT.VERfi 
CT.08JECT 
CT. ADVERB 



CT.l 

CT.2 

FUNCTION 



48 

FILE -NUMBER 

DECIMAL FORMAT RESULTS IF TRUE 
CQ80L C"PIC 999 w > 
ELSE BINARY C8IT C24>> 
i-il 

RESULT FIELD LENGTH 

BASE RELATIVE RESULT FIELD AOORESS 
RETURN THE COUNT OF THE MESSAGES CONTAINED 
IN THE QUEUE-FILE SPECIFIED. IF THE OBJECT 
IS A QUEUE-FILE-FAMILY* THE COUNT WILL BE 
RETURNED AS A LEFT-JUSTIFIED ARRAY OF 
24-9IT COUNTS, ONE FOR EACH MEMBER OF 
THE FAMILY. 



CT.VER8 50 

Refer to P.S. 2212 5470. 



££I*AIIfilfiUX£S 

CT.VER8 51 

CT. OBJECT FILE NUM8EI 
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CT. ADVERB COHNUNICATE LEVEL CHK 7.0 LEVEL = U 
CT.I TOTAL ATTRIBUTES t m ST 8E i IN 7.0) 

CT.2 BASE RELATIVE ADDRESS Of ATTRIBUTE LIST 



CT.VER8 52 

CT.GBJEXT FILE $UN8ER 

CT. ADVERB CGHHU^ICATE LEVEL CHK 7.0 LEVELED 

CT.i TOTAL ATTRIBUTES imsi 8E 1 IN 7.0) 

CT.2 8ASE RELATIVE ADDRESS OF ATTRIBUTE LIST 



A£££££*fiLflfiAl.£ 



CT 
CT 



.VERB 
OBJECT 



CT.3 



55 


i 



CT. ADVERB 

CT.I and CT.2 A 



4 
5 

6 

S EC 



CT.3 CONTAINS AN ABSOLUTE HEMQRY ADDRESS 
HINTS. CT.3 WILL BE USED AS AH OFFSET 
INTO THE FIELD 

OF CT. ADVERB AND CT.3 IS 



1 RS. NUCLEUS. USE 

DESCRIBED BELOW 
' IOAT. USE OF CT 

CRIBEO BELOW 
' DCH.SCRAICH.HEH 
' PACK. INFO TABLE 
' SPG. S3 
BELOW 



ADVERB AND CT.3 IS CES- 



BASE-RELATIVE SDL DESCRIPTOR WHICH SPECIFIES 
THE RECEIVING FIELD IN THE PROGRAM. THE FIRST 
EIGHT BITS OF CT.I ARE IGNORED BY THE HCP 

SEE 3EL0H 



Since HINTS actually begins at absolute location zero* there is 
no functional difference between reading an absolute memory 
location and reading HINTS with an offset. Both settirgs of 

CT. OBJECT are allowed to accomodate possible future expansion to 
the function of accessing HINTS. 

When reading Run Structure Nuclei* all nuclei are returned if 
CT. ADVERB is set to zero. The number of nuclei that are 

currently present in memory is returned as a self-relative valua 
in R5.REINSTATE.HSG.PTR. All of the nuclei will be copied to the 
receiving field in the program in the order that they are linked 
in memory and up to the limit contained in the size specification 
in CT.I. If the nuclei of all executing programs are transferred 
to the receiving field before it is exhausted* the retaining 
portion of the field will be set to blanks. 



To access the Run Structure Nucleus of one particular executing 
program* CT. ADVERB should be set to one and the job number of the 
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program should toe contained as a twenty-four bit binary value in 
CT.3. If CT.3 contains zero* the nucleus of the reguestinq 

program wilt be returned- If the nucleus of the program 

specified by CT. 3 is not In memory for any reason* the receiving 
field will be set to 3FFFFFF3 and filled with blanks and a 
seif -relative value of one wit I be returned in 

R5. REINSTATE. MSG.PIR. 



When reading the IOAT* if CT.AOVERB is set to zero* CT.3 will be 
used as an offset into the I0AT and the remaining portion of the 
table wiit be transferred* up to the 4imit specified in CT.l- 
The .value of CT.3 say be zero* of course* and the entire table 
may be transferred. If CT.AOVERB is set to one* CT.3 will be 
assumed to contain the twenty-four bit binary value of a file 
number associated with a file which the program currently has 
open- All of the I0AT entries which follow the associated entry 
way be transferred* depending upon the value contained in CT.i. 
If the file is not open or is not present in memory for any 
reason* ZFFFFFF3 wHl be transferred* the remainder of the 
receiving field will be set to blanks and RS. REINSTATE. fcSG.PTR 
wilt be set to a sel f -r elati ve value of one. 

If CT.AOVERB is set to a value of two when reading the IOAT* the 
tow-order twelve bits of CT.3 will be assumed to contain a 
Port/Channel/Unit combination in the following format: 

Bits 12 - 14 Port 
8its 15 - IS Channel 
Bits 19 - 23 Unit 

The HCP will scan the IOAT for the entry associated with the 
specified unit and will return that entry plus all subsequent 
entries up to the limit of the IOAT or that specified in CT.l. 
If the specified unit is not present in the IOAT* the HCP will 
set the receiving field to 3FFFFFF3 followed by blanks and wilt 
set RS. REINSTATE. MSG.PTR to a sel f -r el a ti ve value of one. 

JgQ£*Efi £££Ji££IIflL IQUIIM 

CT.VERB 56 

CT. OBJECT FILE NUMBER 



CT. ADVERB BI 




1 REPORT TQ USER ON PARITY 
Z 

3 RESULT MASK FIEL05 PRESENT 

4-5 

6-7 RELATIONAL OPERATOR 

EQUAL TO 

1 GREATER THAN 



7-6J 



BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 



COMPANY CONFIDENTIAL 

81000 MCP II 

P.S. 2212 5462 CE> 



CT-1 
CT.2 
CT.3 
CT.4 
CT.5 
C T »8 
CT.7 



3-10 



Z NOT LES THAN C> I =) 

SELECTION CONDITION 






NEXT 


I 


PRIOR 


z 


FIRST 


3 


LAST 


4 


NEXT AT 


5 


CURRENT 


6 


AT 


7 


RANDOM 



11 

LENGTH OF RESULT MASK 
ADDRESS OF RESULT MASK 



STRUCTURE NUMBER 

KEY ADDRESS 
KEY LENGTH 



XtiJ2£X£I2 3EAU£HII*L fi£4Q 



CT..VERB 
CT. OBJECT 
CT.ADVER3 



CT.l 
CT.2 

CT,3 
CT.4 

CT-5 
CT,6 
CT.7 



57 
FILE 

BIT 



1 

2 

3 

4-5 

8-7 



NUMBER 

REPORT 

REPORT 



TO 
TO 



USER 
USER 



ON 

ON 



EOF 
PARITY 



l-l 



RESULT MASK FIELDS PRESENT 

RELATIONAL OPERATOR 

EQUAL TO 

1 GREATER THAN 

2 NOT LESS THAN C> I =} 
SELECTION CONDITION 

NEXT 

1 PRIOR 
Z FIRST 

3 LAST 

4 NEXT AT 

5 CURRENT 

6 AT 

7 RANDON 
11 

LENGTH OF RESULT MASK 
ADDRESS OF RESULT MASK 
LOGICAL RECORD LENGTH 
LOGICAL RECORD ADDRESS 
STRUCTURE NUMBER 
KEY ADDRESS 
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OS^SEfi £01i£MUL HSIIE 



CT.VER8 
CT.Q8JECT 

CT.ADVER8 



CT.l 
CT.2 
CT. 3 
CT.4 
CT.5 
CT.6 
CT.7 



NUMBER 

REPORT 

REPORT 



TO 
TO 



USER 

USER 



58 

FILE 

8IT 



1 

2 

3 

4-11 - 

LENGTH OF RESULT MASK 

ADDRESS OF RESULT MASK 

LOGICAL RECORD LENGTH 

LOGICAL RECORD ADDRESS 

STRUCTURE NUM3ER 

KEY ADDRESS 



ON 
ON 



EOF 
PARITY 



RESULT MASK FIELDS PRESENT 



IH££X£J2 3£fll2£J!!XI4L MUMl£ 



CT.VER8 
CT. OBJECT 
CT. ADVERB 



CT.l 
CT.2 
CT.3 
CT.4 
CT.5 
CT.6 

ci.r 



59 

FILE NUMBER 

SIT 



1 

2 

3 

4-Ii - 

LENGTH OF RESULT MASK 

ADDRESS OF RESULT MASK 

LOGICAL RECORD LENGTH 

LOGICAL RECORD AOORESS 

STRUCTURE NUH3ER 

KEY ADDRESS 



REPORT TO USER ON PARITY 
RESULT MASK FIELDS PRESENT 



I3fi£*£fi 5£iEll2£JSfII4L fl£i.£IE 



CT.VER8 
CT. OBJECT 

CT.ADVER8 



CT.l 
CT.2 
CT.3 
CT.4 
CT.5 
CT.6 



60 

FILE NUMBER 

SIT 



1 REPORT TO USER ON PARITY 

2 

3 RESULT MASK FIELDS PRESENT 

4-11 - 

LENGTH OF RESULT MASK 

AOORESS OF RESULT MASK 



STRUCTURE NUMBER 
KEY ADDRESS 
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SZUing IIQ MUBJiHIfiAK z Jlifll 



CT.VERB 
CT. OBJECT 

CT. ADVERB 



CT.l 
CT.2 
CT.3 

CT.4 
CT.5 

CT.6 

REINSTATE. MSG, 



(ADDITIONAL 



61 
FILE 

BIT 



I 

Z 

3 

6-7 



-II 



NUMBER 

REPORT 
REPORT 

REPORT 
RESULT 



TO USER ON 
AND RETURN 
AND RETURN 
MASK FIELD 



EOF 

TO USER 

TO USER 

PRESENT 



ON PARITY 
(INCOMPLETE I/O! 



RELATIONAL OPERATOR 

EQUAL TO 

1 GREATER THAN 

2 NOT LESS THAN 



LOGICAL RECORD BIT LENGTH 
LOGICAL RECORD BASE RELATIVE BIT 
ACTUAL BINARY DISK KEY (RELATIVE 
SUPPLIED 3Y USER 



ADDRESS 
KEY) 



MASK FIELD 
RESULT MASK FIELD 



LENGTH IN BITS OF RESULT 
BASE RELATIVE ADDRESS OF 
PTR 

GOOD READ 

END OF FILE 

I/O ERROR 

INCOMPLETE I/O 

FOR FILE STATUS DEFINED IN THE SEQUENTIAL 




I 
2 
3 
ITEMS 



FILES DESIGN SPECIFICATION) 



fi£LAIIJ£ UQ QMmM&hm 1 «fiil£ 



CT.VERB 
CT. OBJECT 
CT. ADVERB 



CT.l 

CT.2 
CT.3 



CT 
CT 



62 

FILE 

BIT 



1 

2 

3 

4 



NUMBER 

REPORT TO USER ON EOF 
REPORT AND RETURN TO USER 
^EPmi AND RETURN TO USER 
RESULT MASK FIELD PRESENT 
ACCESS TYPE 

SEQUENTIAL (NEXT) 

1 RANDOM CAT KEY) 



ON PARITY 
(INCOMPLETE 



I/O) 



5-11 - 

LOGICAL RECORD 81 T LENGTH 

LOGICAL RECORD BASE RELATIVE BIT ADDRESS 

ACTUAL BINARY DISK KEY FOR RANDOM OR DYNAMIC 

FILES (SUPPLIED 8Y USER* NOTHING IF IN 

SEQUENTIAL MODE) 

LENGTH IN BITS OF RESULT MASK FIELD 
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CT-& 8ASE RELATIVE ADDRESS OF RESULT MASK FIELD 

REINSTATE. MSG.PTR 

GGOO READ 

1 END OF FILE 
I I/O ERROR 

3 INCOMPLETE I/O 
(ADDITIONAL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES DESIGN SPECIFICATION) 



CT.VERB 
CT. OBJECT 
CT. ADVERB 



63 






FILE 


NUMBER 




8IT 









REPORT TO USER ON EOF 




1 


REPORT AND RETURN TO USER 


ON PARITY 


2 


REPORT AND RETURN TO USER 


(INCOMPLETE I/O) 


3 


RESULT MASK FIELD PRESENT 




k 


ACCESS TYPE 

SEQUENTIAL (NEXT) 

1 RANDOM (AT KEY) 





5-11 - 
CT.l LOGICAL RECORD SIT LENGTH 

CT.£ LOGICAL RECORD BASE RELATIVE 8IT ADDRESS 

CT,3 ACTUAL 8INARY DISK KEY FOR RANDOM OR DYNAMIC 

FILES (SUPPLIED 8Y USER; NOTHING IF IN 

SEQUENTIAL MODE) 
CT.4 

CT.5 LENGTH IN BITS QF RESULT MASK FIELD 

CT.6 BASE RELATIVE ADDRESS OF RESULT MASK FIELD 

REINSTATE. HSG*PTR 





GOOD READ 






1 END OF FILE 






Z I/O ERROR 






3 INCOMPLETE I/O 






(ADDITIONAL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 




FILES DESIGN SPECIFICATION ) 






THE REWRITE COMMUNICATE WILL BE ESSENTIALLY 


THE SAME AS 




THE WRITE* &UT WILL HAVE A DISTINCT MEANING 


IN LOGICAL I/O 
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cr, 


.VERB 64 




CT, 


.OBJECT FILE NUMBER 




CT, 


.ADVERB BIT 

REPORT 10 USER ON EOF 






I REPORT AND RETURN TO USER 


ON PARITY 




2 REPORT AND RETURN TO USER 


(INCOMPLETE I/O 




3 RESULT MASK FIELD PRESENT 






4 ACCESS TYPE 





SEQUENTIAL (NEXT) 
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RANDOM CAT KEY) 



5-1 1 



CT.t 
CT.2 
CT.3 



CT.4 
CT.5 

CT.& 

REINSTATE, 



ACTUAL BINARY DISK 
FILES {SUPPLIED 8Y 
SEQUENTIAL MODE) 



KEY FOR RANDOM OR DYNAMIC 
USER! NOTHING IF IN 



CADDITIONAL 



LENGTH IN SITS OF RESULT 
BASE RELATIVE ADDRESS OF 
HSG.PTR 

QQOO READ 

1 END OF FILE 

2 I/O ERROR 

3 INCOMPLETE I/O 
ITEMS FOR FILE STATUS 



MASK FIELD 

RESULT iWASK FIELD 



FILES DESIGN SPECIFICATION) 



DEFINED IN THE SEQUENTIAL 



CT.l 
CT.2 
CT.3 



ON PARITY 
{INCOMPLETE I/O) 



fl£UIIJt£ UQ ZQMUMUm z BUS 



ra USER ON EOF 

AMD RETURN TO USER 

AND RETURN TO USER 

MASK FIELD PRESENT 

TYPE 

SEQUENTIAL {NEXT) 
X RANDOM CAT KEY) 
5-11 - 

LOGICAL RECORD BIT LENGTH 

LOGICAL RECORD BASE RELATIVE 8IT ADDRESS 
ACTUAL BINARY DISK KEY FOR RANDOM OS DYNAMIC 
FILES CSUPPLIEO 8Y USER* NOTHING IF IN 
SEQUENTIAL MODE) 



CT. VERB 
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CT. OBJECT 


FILE 


NUMBER 


CT. ADVERB 


BIT 









REPORT 




1 


REPORT 




2 


REPORT 




3 


RESULT 




4 


ACCESS 



CT.4 
CT.5 
CT.S 

REINSTATE. M5G.PTR 





LENGTH IN BITS OF RESULT 

BASE RELATIVE ADDRESS OF 



MASK FIELD 
RESULT MASK FIELD 



{ADDITIONAL 



GOOD READ 

1 END OF FILE 

2 I/O ERROR 

3 INCOMPLETE I/O 
ITEMS FOR FILE STATUS 



DEFINED IN THE SEQUENTIAL 



FILES DESIGN SPECIFICATION) 
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CT.VER8 
CT. OBJECT 
CT. ADVERB 
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FILE 
BIT 



NUMBER 



7-73 

BURROUGHS CORPORATION COHPANY CONFIDENTIAL 

COMPUTER SYSTEMS GROUP 81000 MCP II 

SANTA SAR8ARA PLANT P.S. 2212 5462 CE> 

REPORT AND RETURN TO USER ON EOF 

1 REPORT AND RETURN TO USER ON PARITY 

2 REPORT AMO RETURN TQ USER ON INCOMPLETE I/O 

3 LENGTH AOORESS PART IS PRESENT FOR THE RESULT 
MASK 

4-H - 

CT.l LOGICAL RECORD SIT LENGTH 

CT.2 LOGICAL RECORD BASE RELATIVE BIT ADDRESS. 

CT.3 RANQOH FILE ACTUAL BINARY KEY 
CT.4 

CT.5 LENGTH IN BITS OF RESULT MASK 

CT.6 8ASE RELATIVE AOORESS OF RESULT MASK FIELD 

I2li2£*£fii:5£iMiEJiII4L flCEfl 

CT.VERB 6f 

CT. OBJECT FILE NU«8ER 

CT. ADVERB SIT 

REPORT. FILE. HISSING 

1 REPORT. FILE .LOCKED 

2 REPORT. EXCEPTION {SECURITY ERRORS) 
3-11 

(THE OPEN TYPE IS TAKEN FROH THE FP8. ADVERB AND 
FP8. EXPANDED. ADVERB FIELDS) 
CT.l LENGTH OF USERCODE/PASSWORD FIELD 

(IF QPEN.QN.3EHALF.0F> 
CT.2 3AS£ RELATIVE AOORESS OF USERCQDE/P ASS WORE FIELO 

CT.3 OPEN STATUS - RESERVED FOR THE SMCP TO KEEP TRACK 

OF HHERE TO RESUME IF THE ENTIRE OPEN CANNOT 8E 
COMPLETED. 
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A message queue system has existed in HCP II since 1973, This 
section describes the current Queue impl ementat ion and the 
interfaces between the Queue system and other system software. 

The word "Queue* as used In this document* most often refers to 
the actual data structure maintained by the operating system. 
This data structure is used as a means of inter-process 
communication. Queues may have various attributes lust as files 
do* For example* Queues may have two ten-character names* user 
counts* message counts* and so forth. The data structure is used 
to address a list of messages. This list may be empty. A Queue 
user may add to the back or remove from the front of this list. 
The Queue may be shared ~- one or more processes may put messages 
in the list and one or more processes may remove messages. Only 
the HCP may access the data structure directly. User programs 
must use other mechanisms* which are constructed from this data 
structure* such as Queue Files or demote Files. 



Q£2Jfitf ££IU2M£iI 



The design of the data structure CFigure 6-i) was strongly 
affected by the need to reduce the 5-memory needs of cueues. 
Reusable structures like message buffers and message descriptors 
&re pooled for the use of the whole queue system. The memory 

space used by empty message buffers and descriptors is not 
automatically returned to the system. The Queue implementation* 
father* retains them for later use. This results in cuicker 
allocation when this space is required again and in less 
disturbance of the working set of the code In the system. Since 
Queue Files and demote Files are unblocked* their FIB'S need not 
have buffers. This minimizes the amount of memory required to 

contain the FIB. 



iULUZ £!££ Lh&lLIZS 



A Queue File Family may consist of a maximum of 1023 Queues* each 
having the same first name or MFID and the same attributes. A 
Queue Fiie Family is shown di agr ammaticall y In Figure 8-2. A 

user program may REAQ a message from one of the individual Queues 
in the fanily or it may request a message from any queue in the 
family. On a WRITE operation* however* the individual family 



BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 

member must be specified. 



CGHPANY CONFIDENTIAL 

B10OO MCP II 

P.S. 2212 5462 (E) 



If Individual Queues of a Queue File Family are to be addressed* 
the Individual member must be specified by an ordinal number* or 
key* much tike Switch Files in certain languages- A key of zero 
specified on a Read of a Queue File Family means that the user 
will accept a message from any of the individual Queues which 
comprise the family* y^ ^(ect^c £g&rt~~ 
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For a given Queue* the Queue name* maximum iength* pointers to 
first and last messages* etc* are stored in the Queue Descriptor. 
The descriptor must be in memory during the existence of the 
Queue. Users of the Queue are given "Q-keys"* which serve as 
pointers to the Queue Descriptor* when the Queue File is opened 
and the user has specified the desired attributes of the Queue. 
For a Queue File* the Q-fcey is stored in the file's FIB. If the 
Queue is empty* the 360-bit descriptor is the only memory 
structure dedicated solely to the Queue. 



MLUL MM 



Messages stored in a queue may reside on disk or in memory. At 
Queue creation* an area of system disk is obtained for the Queue 
large enough to hold Q.HAX.HE5SAGES of size Q. HAX. HESS AGE. SIZE. 
These two attributes are normally specified by the user. A Queue 
specified to contain a maximum of 255 messages* each of a laximun 
size of 200 bytes will require 255 *«2Qu+i79> OIV 180) or 510 
disk segments* where OIV denotes an Integer Divide operation. 
The required disk space will be allocated when the Queue is 
opened* prior to the time it is actually required. This is done 
to minimize the processing required to store the message or disk. 
Users who have minimal amounts of disk storage available may 
control the amount that is required by Queues by manipulating 
Q.ttAX.NESSAGES. The disk space that is allocated to Queues is 

not locked in the directory. If the system fails while Qieues 
are active* the disk is returned to the available list during the 
ensuing Clear/Start operation. Oisk is always allocated to 

Queues* even if sufficient memory is available to contain the 
maximum number of messages. 



Queue messages are written to disk when a message being put into 
a queue makes the count of messages in memory equal to tha 
attribute Q.SUFFER5. When this situation occurs* a disk write 
operation on the last message in memory in the Queue is 
initiated. This will make one of the buffers available for an 
ensuing insertion in the Queue. There is one exception to this 
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statement. The disk Write operation wilt not be initiated by the 
Queue routines if the attribute Q. BUFFERS is equal to or greater 
than the attribute Q.NAX. MESSAGES* In this case* messages 

associated with the Queue may only be written to disk by the 
Memory Management routines. The Memory Management routines may 
write Queue messages to d i sic anytime memory is required in the 
system. This ensures that Queue messages will not fill iseiory to 
the point where thrashing occurs. 

When a user removes* or READs* a message from a Queue the first 
message in the Queue is transferred to his Run Structure ard the 
next message in the Queue is examined to determine if it is on 
disk. If it is* a look-ahead disk Read operation is initiated to 
minimize the time that the user will have to wait for delivery of 
the next Queue message. 

The I/O descriptors that are used for the disk Read and Write 
operations Just described reside in the Queue File's FIB. For 
each mode of use* input or output* a program opening a Queue File 
is given one I/O descriptor. A file opened input and output is 
given two I/O descriptors* I/O descriptors are shared among ail 
members of a Queue File Family* so that no Queue File FI8 will 
ever contain more than t**o I/O descriptors. 

The method of storing messages in the queue is by means of a 
linked list of Message Descriptor s* Each Message Descriptor (MQ> 
consists of an SO-bit system descriptor and two link fields* for 
a total of 128 bits each. The system descriptor actually 

describes the message text* according to normal MCP conventions. 

To reduce checkerboarding* MD*s are allocated in blocks of ten* 
Assigning a Hessage Descriptor to a message is accomplished by 
searching the block! s) of ten for an available MO* If none are 
available* memory space for an additional block of ten is 
obtained via a call on the Memroy Management routines. The 

blocks of Hessage Descriptors are surveyed periodically to 
consolidate and return unused blocks to the system. At least one 
block is retained as long as any Queues exist. 

t!E££Afi£ mtllM 

If a queued message is in memory* the memory area which contains 
the message is known as a Hessage Suffer 1MB). The ML. TYPE field 
in the memory link which describes the area will be set to a 
unique value which denotes a Message Buffer. No Queue will ever 
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have mors than G.8UFFERS messages in memory at any time* 
including those messages which are in transit between memory and 
disk. Actual! y» since the Memory Management routines are capable 
of writing Oueue messages to, disk and removing them from ternary* 
the Queue routines cannot quarantee that any messages will be in 
memory at any given time. 

tt2£12f AIIfiHUI£3 

In addition to attributes cosion to alt files* the user may 
specify two attributes whose interpretation has leaning for Queue 
Files only: 



1* Q.MAX. MESS AGES - the maximum number of Messages a Queue can 
store* at which point it is considered full Cmaxiaun 1023). 

2. Q .FAMILY* SIZE - the number of sub-queues in a Ouete File 
Family (maximum 1023)* 

In addition* Q. BUFFERS as described in the foregoing way be 
specified by the BUFFERS file attribute* Thus* the user may have 
some control over the number of messages that may be contained in 
memory at any given tine. In the COBOL Language* a 3uet«e File 
Declaration may appear ass 

SELECT MY*G ASSIGN TO QUEUE. 



FD MY.G VALUE OF 0*MAX*MESSAGE S IS 2< 

RESERVE 3 ALTERNATE AREAS. 
01 MY.Q.8UF PIC XC80). 

SELECT MY. OFF ASSIGN TO QUEUE* 



FO MY.3FF FILE CONTAINS 3 QUEUES 

VALUE OF 9. MAX. MESSAGES IS 10 

RESERVE 2 ALTERNATE AREAS* 
01 HY.QFF.BUF PIC X<80). 

If a Queue File Family is opened* the same attributes apply to 

every neiber individually. In HY.QFF above* for example* all 

three members lay hold ten messages* each having a maximu« of two 
in memory* 
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The name assigned to a fiueue File is specifed by the user as the 
MFID/FIO combination. For a Queue File Family* the HFIO is 
specified by the user and is taken to be the first ten 
characters* and an FIO is synthesized from the member number for 
each queue in the family. The first member of HY.QFF would be 
named w NY.QFF/#OOOuG00I w . 

When a Queue File is opened* the HCF compares the 20-eharacter 
name with the names of ail Queues currently in existence. If a 
Queue of that name if found* the opener is linked to the existing 
queue and the Queue*s user count is incremented. If the Queue 
does not exist* a. new Queue is created with the attributes 
provided by the FP8. Queue attribute binding occurs when the 
Queue is first created* by the first process to open the Queue 
File. If two pro grans share a Queue Ce.g.* both agree on the 

name)* the first program to open the shared Queue file birds the 
attributes • 

Blocking of records is not allowed in Queue Files. The Record 
Size attribute determines the upper limit on the length of a 
message which may be stored in a queue file. 

1UZ£J4E till LQ£I££L IiJ2 IlfiEfiillflJiS 

Queue File logical I/O operations are rather simple ana 
straightforward. As mentioned previously* all Queue Files must 
be unblocked. Truncation or biank fill may occur* depending upon 
the size of the user's work area and the size of the tessage 
being moved* exactly as is done on all other logical I/O 
operations on 81000 systems. The user may request that three 
different exception conditions be reported to him on all Queue 
File logical I/O operations. These three conditions are* in 
COBOL syntax* 

1. ON ENQ-OF-FILE 

2. ON EXCEPTION* and 

3. ON INCOHPLETE-IO. 



On READ operations* ENO-OF-FILE is reported to the user when the 
Queue File is empty and no program exists which has the Queue 
opened for output. EXCEPTION is reported on Queue File Families 
only and on READ operations only* and actually denotes an invalid 
key passed on the READ to specify the desired family seiber. 
INCOMPLETE-IO is reported if the Queue is empty but programs 
stilt exist which have the Queue opened for output purposes. All 
three conditions are reported only if requested* of course. 
Failure to request that £NQ-0F-FIL£ or EXCEPTION be reported will 
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be considered a program error If either condition occurs and 
program will be discontinued. 



the 



The precise weaning of EOF on HEAD is that (a) the last Mr iter on 
this Queue has closed his Queue File and <b) the Queue is eapty. 
EOF is treated as a pseudo-mes sa ge In the Queue. That is# when 
the last message has been read from. the Queue File* the Fite 
stilt exists and actually remains "not empty" for WAIT purposes. 
A subsequent READ will result in the EOF branch being taken. The 
Queue is then empty* but still in EOF status* so if yet another 
HEAD is issued on the Queue File* the reader will again take the 
EOF branch. EOF can be cleared by either the reader closing and 
reopening the file or by the opening of the Queue by a new 
wr iter. 



REAQs to specific members of a Queue File Family are treated 



exactly like READs on single Queue Files. An 
a Queue File Family will return EOF only if 
Family are at EOF (i.e.* empty* no writer si. 
writer closes any member queue of a 
Q. WRITE. OCCUftlRED will be caused for the &FF ? 



reader in the ftEAOY.Q when it WAITS on this event. 



unspecific READ on 

alt ieiders of the 

When the I ast 

SFF* the event 

this will put a 



A MESSAGE COUNT coromu ni ca te operator is implemented to enable 
user programs to determine if any messages are present in the 
Queue Files they are using* This function is described in a 
later paragraph. A MESSAGE COUNT communicate issued for a Queue 
that is marked as being at END-OF-FILE will show the EOF status 
as a pseudo-message - the count for that particular Queue File 
will be one more than the count of real messages. When the 
reader executes a specific HEAD on the member Queue which is at 
EOF* the EOF branch will be taken. The next MESSAGE. COUNT will 
show the member Queue as containing no messages. Another READ on 
the member will result in the EOF branch being taken again* as is 
done for a single Queue File. 

On Queue WHITE operations* END-OF-FILE is not defined and will 
never occur* EXCEPTION has the same meaning as It does for READ 
operations - it denotes an invalid key condition on Queue File 
Families only. INCOHPLETE-IO will foe reported* if requested* 

when the Queue is full and there is no space available to store 
the message that is being written. If no INCOMPLETE-IO report is 
rquested and the Queue is full when a WRITE occurs* the program 
is suspended until space is available in the Queue. 



As mentioned previously* when a logical I/O request is directed 
to a Queue File Family* a key must be included to identify the 
specific Queue in the family to which the operation is directed. 
This is similar to Switch Files in the SOL Language. Family 
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members are numbered logically fro??! one to n. Giving a ley of 
zero on a READ is defined as an unspecified read. The nenbers 
wii«t be searched* beginning with number one* and the first queue 
member found not empty wilt be read. A key of zero on a write is 
invalid. 
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Writing to the top of a Queue File is allowed in the HCP though 



it may or may not be allowed in a given language. 
written to a queue file normally goes to the bottom 
though some rare occurrences in applications o>ay 
converse. This capability is invoked in the 
operation by setting bit 7 of CT. ADVERB. 



A we s sage 

of the Queue 

require the 

comminicate 
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This communicate operation returns the count of messages in the 

Queue file specified. If a Sueue File Family is specified* the 

count of each member will be returned in an array imember one in 

the first position* member two in the second* etc*}* up to the 

limit of the result field. Counts will be returned either in 
decimal <C0BOL "PICTURE 999*) or binary <S0t W 8IH24) W } depending 

on the value of the first bit of CT.A0VER8. This operation may 
not be implemented in all languages. 



Format 



CT.VER8 

CT. OBJECT 

CT.ADVE88 BIT 

CT.l 

CT.2 



48 CHEX 3303) 

File Number 

Decimal format results 

Result field length in 
Result field address 



if true 

bits 
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Reader FIB 

**************** 

* Device= Queue * 

* * 

* * 
**************** Queue Descriptor 

* Q KEY **•-■"■"->*********************<-----* 
**************** 

* Read * 
*IO Descriptor * 

**************** 



* 
* 

* 

* 

* 

* 
------.« .. . « „ « „ «, m > fc 



Writer FI9 
**************** 

* Oevfce= Queue * 

* * 

* * 
**************** 

a KEY * 

**************** 

* Write * 

-->*I0 Descriptor * 
I **************** 



I 



Q.LA3EL= W HY.Q W 

Q.MAX. MESSAGE S=1Q 

Q.M5G.CQUNT=3 

Q.8UFF£RS=2 

Q.NOT.FULL=TRU£ 

«. NOT- EMPTY= TRUE 

Q. FIRST * I 

Q.LASr * | 

I 1 ********************* | 

I HD1 H02 H03 I V 

******** * ******<---->*** * ***********---->*:*** * * * * * * * * * * * * * * 

* IN S-He?»ory * * On 01 sk * * In Process Out * 

*************»»< *H*H*H**ktH< ****************** 



M8 \f 

****************** 

* "FIRST HESSAQE * 

* TEXT" * 

****************** 



He 



****************** 

* "THIftD MESSAGE 

* TEXT" 

****************** 



1 
I 
I 
I 
I 
I 
i 
I 
1 
I 
I 
i 
! 

*<--! 

* 



************************ 
* System Disk * 



************************ 

* * | 
************************ | 

'- — >* "SECOND MESSAGE TEXT** I 
************************ | 

* "THIRD MES>. ........ *< — -i 

************************ 

* * 

************************ 



Figure 8-1: Two Programs Communicating in a Queue File Called 
T-fie Queue contains three messages* 



MY.Q". 
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FIB 

**************************** 

* W MY.8FF W * 

* FI8*MYU5£ = INPUT/OUTPUT * 

* FI8.Q. FAMILY = TRUE * 

* FIB»Q*FAMILY.5IZE* = 3 * 
**************************** 

* Q.KEY I * 

**************************** 

* Q.KEY 2 * 

**************************** 

* 9-KEY 3 * 

**************************** 

* READ 10 OESCR * 

**************************** 

* WRITE 10 OESCR * 

**************************** 



************* ******** 

* "MY.flFF" * 

* "##00000001 * 

* Q. SUFFERS =2 * 

* Q.MAX.M£SSAGES=1G * 

* Q.HSG.CT =0 * 
********************* 

* FIRST * LAST * 

********************* 



********************** 

* "HY*&FF n * 

* "##90000002 * 

* Q. SUFFERS =2 * 

* Q.HA)UMS6»€0UNT=IQ * 

* Q.MSG.CT = 1 * 
********************** 

* FIRST * LAST * 

********************** 



MO 

************** 

* * 

************** 



************************ 

* "MY.QFF* * 

* "##00000003 * 

* 0. SUFFERS = 2 * 

* Q*MAX.HSG. COUNT = 10 * 

* Q.MSG.CT =2 * 

************************ 

* FIRST * LAST * 

************************ 



MO 



*************** 

* * 

*************** 



WD 

************* 

* * 

************* 



Figure 8-2: A Queue-flte Family with three teibers* 
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Another weans of accomplishing inter-process communication is the 
£nter-Program Communication Module* first i tuple tented in the 9.0 
software to satisfy the requirements of the ANSI «74 COBOL 
Language* According to the specifications of that language* th* 
facility provides synchronous CALL and EXIT verbs* as welt as a 
shared data implementation. The module provides a facility to 
transfer control from one program to another and the ability for 
both programs to have access to the same data items. The names 
of the programs to which control is to be passsed say or nay not 
be known at compile time* Additionally* this module provides tha 
ability to determine the availability of memory for the program 
to which control is being passed* 



flUJH UMI UglMlHM 



The definition of a "Run Unit" is critical to the impi ement ati on 
of the CALL/CANCEL mechanism described in the ANSI *74 C080L 
specifications. The execution of any pro graft via an EXECUTE 
control instruction does not establish a Run Unit* A Run Unit is 
established only when an executed program initiates another 
program via the CALL communicate* That called program is now a 
member of the Run Unit associated with the program that was 
originally executed. Similarly* any program called by a program 
within the Run Unit becotes part of that Run Unit ami remains in 
that Run Unit until terminated or cancelled. A job cannot be a 
member of more than one run unit* The following figure 

represents seven programs CA - G3 which have been called within a 
run unit* 

A CA was Executed) 

1 

I <---- Current Path 



Previous -■---> 
Path 



. \ 

\ 

C 
1 
I 

6 E 



The connecting linfcs are generated by and represent the last used 
path* and the link exists until a return CEXIT PROGRAM) is 
accomplished. Once a called program has been exited CO- F* 3)* 
it remains suspended in its current state. The only path that is 
of interest is the path last traversed* 
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The current path is i«portant in order to check the validity of a 
CALL or CANCEL statement? if a program tries to CALL or CANCEL 
itself or any of its predecessors* the entire run unit will be 
0S*ed. The other links are unimportant* as any program in the 
run unit can CALL or delete other existing programs* with the 
previously mentioned exceptions* or can CALL new programs* 

If* for exaipie* program *E* cancels pro gran *D* then the Run 
Unit would consist of alt of the following programs and appears 

a s t 



A 


Unat tached 


1 


Programs 


J 


F* G 


8 




1 




! 




C 




i 




I 




E 





A CALL to any of these programs wilt result in a transfer of 
control to the existing state* whereas a CALL to any other 
program* including *Q f # will cause an initial state copy to be 
invoked before control is transferred. The termination* via STCP 
RUN or A8QRT* of any program in a Run Unit will result in the 
re m oval of all pro grans in that Run Unit froi memory* 

IE£ IJHEL£S£iflIAIIflfl J2£ 3JJASEJ2 MIk 

For those not familiar with the ANSI »74 COBOL definition of 
Inter-Program Communication* all programs within a Run Unit 
execute synchronously. Hq two programs in a Run Unit say foe 
executing simultaneously at any time and consequently* there are 
no problems associated with two or more programs contending for 
the use of shared data. Control is passed to a program via the 
CALL verb* The program which contains the CALL will rot be 
allowed to execute again until 'the called program performs an 
EXIT PROGRAM verb. 

The calling program may specify one or more data items to which 
the called program has access. The shared data may be any 01 or 
77 level item described in the calling program This includes 
items whose addresses have been received through a CALL. The 
data items may be named and defined differently in each program 
as long as the length of the item remains the same in each 
program. This mechanist is stricly a "pass by name" facility. 
Parameters cannot be passed by value. Additionally* storage for 
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the shared data is never allocated In the called program. In 

other words* the address of the data* only* is always passed to 

the called orograai. 



I££ BUM SlfiUfililfiE UUSiLl^ £di£ii££ 



In order to maintain ail of the necessary information regarding 
the prograiis which comprise a Run Unit* several fields were added 
to the Run Structure Nucleus* RS* NUCLEUS* the field in lemory 
which contains information about each progracn that is executing* 
in the 9.0 version of the HCP. This field* as it has always 
been* is shared by the Operating Systesi and the user programs 
interpreter* The following is a list of the fields which were 
added in the 9*0 version and a brief description of each. 



fi£*fi]2*.ftJiNII mu^i 



When a Job initiates a CALL* he establishes a RUN UNIT, This Run 
Unit is identified by his own (the or i ginator f s) Job nusber. 
RS.8UN.UNIT* for any job in the Run Unit* will contain the job 
number of the program which initiated the Run Unit. 



R5*.Mtt*UMl±UM Mlllai 



This field wilt contain zero for the job that initiated the run 
unit and for any Job in the Run Unit that has done an EXIT 
PROGRAM* For any fob that is currently active in the Run Unit* a 
job that has not done an EXIT* this field will contain the j oa 
number of his caller. 



££*I££4J}I£I MI1242 



This field will contain the absolute address of the 
IPC. DICTIONARY through which parameters will be accessed within 
the calling job's base-limit space. The field will be zero if 
the dictionary does not exist. This is the list of parameters 
that this job will pass. The IPC .DICTIONARY is adjacent to tha 
RS.NUCLEUS and found only in the callers Run Structure Nucleus. 
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This field will contain the absolute address of the 
IPC. PARAMETER. LIST* This space will be adjacent to the Run 
Structure Nucleus for any called \ ob that can receive parameters. 
The IPC. PARAMETER. LIST will be a series of Zh bit fields. The 

first field will contain the number of parameters that this job 
is capable of receiving. The regaining fields in the list will 
contain the length in bits of each parameter. This list is built 
only for the called program frost the IPC. PARAMETER. LIST in the 
called program's code file that is generated by the comoiler. If 
the Job cannot receive parameters* this field will contain zero. 



B3*I££*M£I A 1IZ£ UlLlkl 



This field will contain the number of entries in this program's 
IPC Dictionary. 



&$*U£QUm*H££ illUl 



This field is used to store the type of execution that originated 
the job. If the Job is not an Execute type or a Call type* then 
it cannot be called. The field can contain the following values: 



1 = Execute 




Z = Compile and Go 




3 = Compile for Syntax 




4 = Compile to Library 




5 = Co rap it e and Save 




6 = Go Part of Compile 


and Go 


1 = Go Part of Compile 


and Save 


8 = Call 




SSiMBS £HMMI£B£i2i 





This field will contain the name of this program. In the case of 
compilations* denoted by he value of the previous field* it will 
contain the name of the compiler as Melt. 
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This field will contain the Limit Register of this fob's caller. 



B5xl££*£UU Ul ill 



This field is a dummy event for any IPC hang or suspension of 
execution. If a program is waiting on RS. IPC. EVENT and is 
currently passive* which will be indicated by a zero value in 
RS. RUN. UNIT. LINK* the RS. STATUS will be set to a value to 
indicate "Waiting to be Called". If the program is currently 
active* indicated by a non-aero value in RS.RUN.UNIT.LINK* the 
RS. STATUS will be set to a value indicating "Waiting on caltea 
progran"* 



I£*£48££L££ 21II12 



If this boolean is true* then at least one CANCEL communicate has 
been issued against this program. When this is true* this 

particular job is effectively no longer a member of the Run Unit 
and is watting to be terminated by the SMC P. 



I££ Er.3301 lataM&t&z iiasi £1)20 a&s 



It was also necessary to make changes in the Program Parameter 

Block* the two-sector field that is generated by the compilers 

and stored in the code file* to accomodate the IPC 

ifnpl eraentation . A Cist of the fields that have been added is 
presented below. 
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This field indicates the number of. entries in the 

IPC. PARAMETER. LIST. If tni s field is not equal to zero* it 

indicates to the MCP that this program can only be called - it 
can never be EXECUTEd. 
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This field is used to store the relative disk address in the code 
file of the IPC. PARAMETER. LIST. The IPC. PAR AMETER. LIST will be a 
series of 24 bit fields that contain the length in bits of the 
parameters that nay be passed to this prograi with a CALL. 



££fifi«I££*£a**S£a'fl«£JB.&tfS SIII1&1 



This field indicates the maximum number 
passed by this program through a CALL* which 
number of entries in the IPC Dictionary. 



of parameters to be 
will also be the 



It was also necessary to add a field to the format of the Pro gran 
Parameter Block that is used by the HCP after the job is 
scheduled for execution. This field* known as PPS.RUN -UMT*. is 
sixteen bits in length and is used to contain the Job nunber of 
the run unit that this program will become a part of. 



I££*flI££jgHAfiX 



Tne IPC. DICTIONARY is a list of Systen Descriptors built by the 
prograaj to describe the parameters to be passed on a CALL. This 
dictionary wili be within the space defined by flS.IPC.QICT in the 
RS.NUCLEUS of the catting program* The length of this dictionary 
is passed In the CALL communicate. The Hicro HCP will verify 
that the number and length of paraieters passed watch the 
IPC. PARAHETEH. LIST of the called program. 
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One new communicate operator was added to the Operating System to 
accomodate the IPC i mpl ementat ion. This operator is generated by 
the Compilers to implement the CALL* CANCEL and EXIT PROGRAM 
verbs. It may be handled by the Micro MCP or the SOL MCP* 
depending upon the circumstances* Its format Is presented below 
and in the Demand Management section* 



CT.VERB 
CT. OBJECT 



CT. ADVERB 



CT.l 



43 

= CALL 

1 ~ C A UC EL 

2 = EXIT PROGRAM C No EOJ> 
Bl t 

- if CALL* return on HQ MEMORY 

1-11 - Not used 
Base relative address of a 30 character 
field that contains the name of the Job 
to be cat led or cancelled. 
dumber of parameters to be passed 



1 1 tt 
RS. REINSTATE. MSG.PTR values returned if requested: 

- Communi ca te couplet ed as requested. 

1 - For CALL# insufficient memory to complete the CALL. 

- For EXIT PROGRAM* the program was initiated by an 
EXECUTE instruction as opposed to a CALL. 

- Hot used for CANCEL* 
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One of the primary objectives of the IPC implementation was 
performance* Therefore* as much as possible of the IPC function 
was i rapt ens en ted in the Micro MCP. In the ANSI f 74 C08GL 

Language* the CALL and CANCEL verbs require the specification of 
program names within the source text* On the 61000 systei* the 
name of a program may be unknown to the user when the program is 
compiled* since the Run Unit may be executed under a Usercode. 



To simplify the task of associating program names with those 
specified by a program in a CALL or CANCEL communicate* a new 
system structure was implemented* A programmatic description of 
the structure* IPC«RUN*UNIT*LI ST* is presented below 
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01 IPC. RUN. UNIT. LIST 

02 IPC. RUN. UNIT. NUMBER 

02 IPC. PGM. NAME 

02 IPC. PGM. JQ8. NUMBER 

02 IPC. PGM. LR 

02 IPC. FGRHARO. LINK 



81TC3203* 



BIT U6>* 
CHARC30)# 
BIT 116)* 
3IT 124)* 
BIT <24)J 



IPC. RUN. UNIT. LIST Is a linked serial list which includes all 
members of alt Run Units. The entries in this list aren't in any 
particular order and are not grouped by Run Unit. The SDL 
portion of the MCP is responsible for the management and 
maintainence of ail IPC. RUN. UNIT. LISTs. The first 

IPC. RUN. UNIT. LIST is addressed by a field in the MCP«s stack, 
Both the S.MCP and the Micro MCP CM. HCP) access these structures 
for informati on. 



I££ £ALl aKfiAIXIlS 



The MICRO HCP receives all CALL communicates* Any named job is 
considered a candidate for a CALL by the Micro MCP. If the 
requested Job is not currently a member of the correct Run Unit* 
then the CALL request will be transferred from the Micro MCP to 
the SDL portion of the HCP* to make the called program present. 

To determine if the requested job is a member of the correct Run 
Unit* the Micro MCP searches the list of Run Units* beginning 
with the first* which is addressed by a field in the HCP stacks. 
Each program that is a member of any Run Unit will be found in 
the serially link list described by the IPC. RUN. UN IT .LI ST 
structure. 



If the program is present* the Micro MCP wilt first examine the 
program's RS. CANCELED boolean in its Run Structure Nucleus. If 

this boolean is true* then this copy of the program has beer 
cancelled and a new copy must be initiated. CANCEL operations* 
like all program termination operations do not happen 
immediately* If a new copy must be initiated* the Micro MCP will 
call the S.MCP to initiate a new copy of the same program. S.MCP 
operations* upon receiving a CALL communicate* are described in 
later paragraphs. 



If the RS. CANCELLED boolean is false* then the Micro ^CP checks 
to determine whether the called Job is active or passive* which 
will be indicated by the RS. RUN. UNIT. LINK field of the Run 
Structure Nucleus. If the job is already active* ther some 
theoretically impossible error has occurred and the Micro HCP 
must call the S.MCP so that the Run Unit can be terminated. If 
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the called program Is found to be passive* then the flicro MCP 
wilt next checi to Insure that the number of parameters to be 
passed* if any* agree. This will be indicated by the calling 
programs RS.IPC.0ICT field being equal to the called program's 
XPC.PARAHETEJULIST, 



If the number of parameters do not match* then the Micro HCP 
calls the S.HCP for termination of the run unit. If the nunoer 
of parameters do agree* the Nicro MCP next checks to insure that 
the length specified for each passed parameter is the sane in the 
calling program and the called program. If any of the length 
descriptions are not equal* the Micro NCP will call the S.HCP for 
termination of the entire Run Unit* 



If parameters are being passed* if the number of parameters is 
equal and if they all have equal length attributes* then in the 
calling program* s Run structure Nucleus* the Hicro HCP incre»ents 
the RS.TENPGRARY. FREEZE field* to fix the program in memory and 
sets the RS .RuU.UMIT.LINK field to the caller*s job number. In 
the Run Structure Nucleus of the called fob* it sets the 
RS .CALLERS .LR field to the limit register of the calling program* 
It then hangs the catling program on its RS.IPC.EVENT field and 
sets the caller's RS. STATUS field to "waiting on 
program** and marks the called Job "ready to run*. It 
noted that It is not necessary to freeze the calling 
memory if parameters ars not passed. 



the called 
should be 
program in 



Considering the case where the called program is not 
the Run Unit and the S.MCP is called upon t 
requested program* whenever the S.MCP receives a "** 
and usercodes are involved* * " - tM **_--. 



a fresber of 
to execute the 
CALL cosfftnicate 
«*,w«w<p «, w ...**» *«u«r *t will first search the list of Run 
Units* using all permutations of the usercoded name* to det 

if the Job exists in the Run Unit under a different 

the new name and corresponding information will be 
the Run Unit List and control will be returned to the Micro HCP. 
If Usercodes are not involved and if the name does not exist in 
the Run Unit List* then execution of the 



er mi ne 
name, if so* 
entered into 



Job must be attempted. 



The S.MCP must then determine that the requested program is 
present on disk. If not present* the program which issued the 
CALL will be hung until the requested program is made present. 
If the requested program is present on disk* the S«t<CP must then 
determine that there is enough lenory to execute the requested 
If there is insufficient memory* The program which 
the CALL may have asfced to be notified of this fact, 
called job will not be scheduled but the prograi which 
the CALL will be notified of the insufficient memory 
If the program which performed the CALL did not 
be nofitied* the called program will be scheduled and 



pr o gr am. 
per formed 
If so* the 
performed 
condition, 
request to 



the calling program will not be allowed to execute until the 
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called program does an EXIT PROGRAM commun icat e. 



Actually* after the called program reaches 8GJ* the S.HCP will 
hang the catted program on his own RS. IPC. EVENT with RS. STATUS 
set to "Waiting to be called" and put the catling program back in 
the M.CQHH.Q. This allows the Hicro WCP to complete the CALL 
operation. 



1££ £M££L UtLMUQU 



All aspects of the CANCEL and EXIT PROGRAM communicate opertors 
are handled by the Hicro HCP . Upon receiving a CANCEL operator* 
the Micro MCP must first deter nine if the Job exists in the Run 
Unit and whether it is active or passive. If it is not present 
or the program is present but its RS. CANCELED boolean is true* 
the request is ignored and the cancelling Job is reinstated. If 
it is present and passive* the Micro MCP wilt then place the 
specified program in the EXTERMINATE. Q* set the RS. CANCELED 
boolean and return control to the job which issued the 
communicate. The EXTERMINATE. 9 wi4t cause termination of the 
] ob. 

A request to CANCEL a Job that is both a member of the Run Unit 
and active is a violation of the COBOL specifications and will 
result in termination of the entire Run Unit. 



I££ Oil £Bflfi£Afl QZ£BAUtm 



If a called job issues an EXIT PROGRAM communicate operation* the 
Hicro HCP will hang the issuing program on its RS. IPC. EVENT 
field* setting RS. STATUS to "Waiting to be called"* decrement 
RS. TEMPORARY. FREEZE in the Run Structure Nucleus of the program 
that called the issuing program and mark the calling program 
ready to run. If a program that was not called issues the 
communicate* the communicate wilt be ignored and control wilt b«a 
immediately returned to that program. 



I££ IL&MMI1M £81£I12£fiJIilllft 



If any program in a Run Unit performs a STOP RUN communicate 
operator* the entire Run Unit will be cancelled and all programs 
in the Run Unit will be discontinued. Similarly* if any program 
in the Run Unit terminates abnormally* the entire Run Unit will 
be discontinued. Programs within a Run Unit may only stop 
execution via the EXIT PROGRAM verb. Normal termination wilt 
occur when the program that initiated the Run Unit terminates. 
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Upon termi nation* for any reason* of any member of a particular 
Hun Unit* the S.MCP will immediately delink ail entries 
pertaining to the specified Run Unit from the Run Unit List. 
When the parent of a Run Unit goes to a normal EOJ* then all fobs 
attached to that run unit wilt be cancelled. If any job ir a 
unit is aborted* then the entire run unit wilt be aborted- 
one program in a Run Unit does a CANCEL on another program in 
sane run unit* then the cancelled job must be delinked from 
run unit and sent to EOJ* 



run 
If 

the 
the 
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The transfer of information between the Micro MCP and the S.MCP 
is accomplished using an existing mechanism. This mechanise 
utilizes the Run Structure Nucleus field* R5*W.PR08L£H. All 

instances of such required communication are shown in the 
following table* The table shows the value that will be stored 
in the RS.MPR08*P2 field* a subfield of R5.M.PRG8LEH* the 
condition that caused the communication and the action that will 
be taken by the S.WCP* Whenever such communication is necessary* 
the R5.HPR08*P1 field* also a subfield* will be set to a value of 
9* which will indicate the family of .problems related to IPC* 



S„HP«0fl.P2 = 



Error Description 



Required Action 



Requested or o gram not 
not in nix* 

Number of parameters 
do not latch. 



S.^CP should make 
program present* 

S.MCP will OS entire 
Run Unit* 



Parameter specs* 
do not agr ee • 

Attempted recursive 

CALL 



S*WCP wilt OS entire 
Run Unit. 

S.HCP will OS entire 
Run Unit. 



Attempted CANCEL 
of predecessor* 

Invalid Communicate 

paramo ters * 

Found requested Job 
and RS. CANCELED true 



S*HCP will OS entire 
Run Unit. 

5*MCP will OS entire 
Run Unit. 

Terminate specified 
job and make new 
copy present. 
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If any teraber of the Run Unit* regardless of whether the 
specified program is active or passive is OS-ed* DP-ed* or DH-ed» 
the entire Run Unit will be duraped and/ if OS-ed or DP-ed# 
terminated. 



i££ £iHJ}li2iI£2 Eflfi JSfiLL-fllll 



After the Micro #CP processes an IPC cossmuni cate* it will not 
purposely mark the appropriate job TG*8E. ROLLED. OUT. If the 
S.ftCP needs fieiory* it will follow the normal selection process 
in determining a candidateCs) for Roll-out. There will be no 
special consideration given to members of Run Units* 



1££ IiiJS CMSIJOMISM 



Each called program will actually become a TASK associated with 
the originator of the Run Unit* By becoming a TASK as opposed to 
a noriat job* several advantages wtii be realized* 

1) TASKS are not subject to MIX limits ar)d other scheduling 

constrain ts. 
2} There wild be corresponding entries in the SYSTEM/LOG. 
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Information passed for the programs nane in the CALL/CANCEL 
communicate will be subject to the same naming restrictions as a 
file with respect to 03 or OP conditions* e«g«# CALLing a program 
with a blanfc HFIO will result in the termination of the entire 
Run Unit. 
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